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 |