Make: catro módulos HTTP e ningunha app

O módulo que se usa

O de sempre cando non hai app: HTTP. E dentro de HTTP, o que fai a petición con autenticación por clave, que existe xustamente para non deixar a clave escrita á vista no escenario.

A diferenza entre usar ese módulo e o HTTP xenérico non é cosmética. Co xenérico, a cabeceira Authorization coa túa clave dentro queda escrita no escenario, e calquera do teu equipo que o abra ve a clave e lévaa. Coa conexión por clave, a clave vive no chaveiro de Make e o escenario só a referencia.

O fallo máis repetido montando isto é poñer só a clave, sen Bearer diante. Sae un 401 no_autenticado e parece que a clave está mal cando o que falta é unha palabra.

Un escenario completo: dun pedido a unha factura

Catro módulos. O primeiro cambia segundo de onde veña o pedido; os outros tres son sempre os mesmos.

O corpo do paso 3, tal cal se pega no campo de contido do módulo, substituíndo o que está entre chaves polo que traia o teu disparador:

{
  "contacto_id": "el id que devolvió el paso 2",
  "serie": "WEB",
  "fecha_emision": "la fecha del pedido, en AAAA-MM-DD",
  "lineas": [
    {
      "descripcion": "el nombre del artículo",
      "cantidad": 1,
      "precio": 180.00,
      "tipo_iva": 21
    }
  ]
}

Copia eses nomes tal cal. Os catro que se escriben mal sempre son fecha_emision (non «fecha»), descripcion (non «concepto»), tipo_iva (non «iva») e, no paso 2, tipo con valor customer (non «cliente»). A API non ignora un campo que non coñece: devolve 422 nomeándoo, así que se un módulo se pon vermello con ese código, o primeiro é mirar error.detalles.campos.

E en cabeceiras de cada módulo, dúas, ademais da que pon a conexión:

Content-Type: application/json
Idempotency-Key: make-1042

A chave de idempotencia, que en Make importa máis ca en ningún sitio

A chave ten que saír do identificador do pedido do disparador, non dunha función de aleatorio nin da data actual: se cambia entre a execución e a repetición, non serve de nada. E unha distinta por operación: make-1042 para crear a factura e make-1042-emitir para emitila.

Por que isto importa tanto e que pasa cando falta, en idempotencia.

Control de erros

Sen control de erros, un módulo que devolve 422 detén o escenario e mándao á cola. Con el, pódese decidir que facer, e a decisión non é a mesma para todos os códigos:

Os sete códigos, con cales se reintentan, están en erros e límites.

E un consello que aforra operacións do teu plan: non montes un escenario que consulte Cairos cada cinco minutos por se hai algo novo. Subscríbete a un webhook e que o escenario arranque cando pase algo. É máis barato, máis rápido e non gasta o límite da API.