API LaFactura.co:WebRecepcion
Revisión del 17:26 29 jun 2022 de Srvadmin (discusión | contribuciones) (Página creada con «==Webhook Recepción de Documentos== Por nuestro sistema de interconexión, podemos enviarte a una URL tuya, una respuesta de tipo automática cada vez que se reciba un doc…»)
Sumario
Webhook Recepción de Documentos
Por nuestro sistema de interconexión, podemos enviarte a una URL tuya, una respuesta de tipo automática cada vez que se reciba un documento electronico en nuestra plataforma.
IMPORTANTE: Para recibir estas notificaciones, debes enviarnos por correo la url específica a la cual quieras que te enviemos los eventos. (La url debe en todo caso ser https)
Objeto:incoming
El objeto incoming lleva el resultado del documento recibido
Ejemplo 1 (Documento recibido pero rechazado por nuestra plataforma)
{ "incoming":{ "type":"email", "status": "98", "tascode": "in-86ba3c44coetireoriterotiebdc042febbbbbf31bd0083-v300", "msg": "Att: firma en modo estricto -2-;Att: No tiene Documentos adjuntos", "email": { "from": "[email protected]", "to": "[email protected]", "subject": "Asunto del correo", "date": "20220629114359", "spam": "false", "virus": "false" } } }
Explicacion
Se recibió un correo en la plataforma:
- Su estado es: Rechazado (98)
- el ID de recepcion del documento en nuestro sistema es: in-86ba3c44coetireoriterotiebdc042febbbbbf31bd0083-v300
- Contiene las siguientes notas acerca del rechazo: Att: firma en modo estricto -2-;Att: No tiene Documentos adjuntos
- Fué enviado por [email protected] al correo [email protected].
- Fue recibido el 2022.06.29 a las 11:43:59
- No es considerado spam o virus
Ejemplo 2 (Documento recibido de manera positiva)
{ "incoming": { "type": "email", "status": "2", "tascode": "em-86ba3cewrowerpoweor44casasebdc042febbbbbf31bd0083-v300", "msg": "Att: firma en modo estricto -2-", "email": { "from": "[email protected]", "to": "[email protected]", "subject": "Fwd: El asunto", "date": "20220629114359", "spam": "false", "virus": "false" }, "document": { "provider": { "name": "XXXX SAS", "id": "900900900", "telephone": "212121", "email": "[email protected]" }, "totals": { "LineExtensionAmount": "45608043.00", "TaxExclusiveAmount": "45608043.00", "TaxInclusiveAmount": "54273571.17", "AllowanceTotalAmount": "0.00", "ChargeTotalAmount": "0.00", "PrepaidAmount": "0.00", "PayableAmount": "54273571.17" }, "general": { "type": "fc", "mode": "1", "num": "FE958", "cufe": "0c35d06916434833335ddddeabf88152b60084be595bfd648329a516568bd8004cea56a7823eba7c1ead7f569662a5a0e9cf88e57", "json": "{\"Invoice\":{.........}}}" } } } }
Explicacion
Se recibió un correo en la plataforma:
- Su estado es: Aprobado (2)
- el ID de recepcion del documento en nuestro sistema es: em-86ba3cewrowerpoweor44casasebdc042febbbbbf31bd0083-v300
- Contiene las siguientes notas acerca del rechazo: Att: firma en modo estricto -2-
- Fué enviado por [email protected] al correo [email protected].
- Fue recibido el 2022.06.29 a las 11:43:59
- No es considerado spam o virus
- Los detalles del documento están incluidos en "Documento"
Campos
Parámetro | Descripción | Tipo | Obligatorio |
---|---|---|---|
tascode | Identificador único, del documento del evento | cadena | SI |
date | Fecha del evento (YYYYMMDDHHMMSS) Ejemplo: 20210125102005 |
cadena | SI |
text | Información del evento en texto | cadena | SI |
alert | Alerta generada | cadena | SI |
process | Información del proceso Solo aparece cuando se trata de un cambio de estado del documento |
objeto | NO |
process->change | Si cambió el estado del documento (true/false) | boolean | SI |
process->newValue | El nuevo estado del documento (Solo si change=true) Estado de proceso: 0 -> En cola 1 -> En proceso DIAN 2 -> Aceptado DIAN 77/78 -> Reintentando Mayor que 90 -> Rechazado DIAN |
numerico | SI/NO |
información de correo | cadena | NO | |
email->email | correo electronico del evento | cadena | SI Solo si el evento es relacionado con correos |
email->status | Estado de transporte de correos 0 -> Correo enviado 1->correo recibido 2->correo rechazado 97-> dominio bloqueado por inexistente o estar en lista negra 98-> correo en lista negra |
numerico | SI Solo si el evento es relacionado con correos |
accept | Estado de aceptacion de un documento por un cliente 1 -> Aceptado 2->Rechazado |
numerico | SI Solo si el evento es relacionado con aceptacion o rechazo de documentos |