API LaFactura.co:WebRecepcion

De API LaFactura.co
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…»)
(dif) ← Revisión anterior | Revisión actual (dif) | Revisión siguiente → (dif)
Ir a la navegación Ir a la búsqueda

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
email 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