API LaFactura.co:WebRecepcion - Historial de revisiones

Srvadmin: /* Campos */

2022-06-29T19:55:04Z

Campos

Srvadmin: /* Campos */

2022-06-29T19:54:30Z

Campos

Srvadmin: /* Campos */

2022-06-29T19:53:02Z

Campos

Srvadmin: /* Ejemplo 2 (Documento recibido de manera positiva) */

2022-06-29T18:04:11Z

Ejemplo 2 (Documento recibido de manera positiva)

Srvadmin: /* Campos */

2022-06-29T17:39:33Z

Campos

Srvadmin: /* Campos */

2022-06-29T17:35:17Z

Campos

Srvadmin: 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…»

2022-06-29T17:26:54Z

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…»

Página nueva

==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": "xxx@ejemplo.com",
"to": "buzondeentrada@xxx.com",
"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 xxx@ejmplo.com al correo buzondeentrada@xxx.com.
*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": "pepito@ejemplo.com",
"to": "buzondeentrada@xxx.com",
"subject": "Fwd: El asunto",
"date": "20220629114359",
"spam": "false",
"virus": "false"
},
"document": {
"provider": {
"name": "XXXX SAS",
"id": "900900900",
"telephone": "212121",
"email": "nicolas.pena@on2design.com"
},
"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 pepito@ejemplo.com al correo buzondeentrada@xxx.com.
*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=====
----
{| class="wikitable"
|-
! 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
|}

@@ Línea 122: / Línea 122: @@
 | URL || URL dispuesta para descargar copia de los documentos recibidos en formato zip<br/><b>Solo si el documento fué aceptado por nosotros</b> || cadena || SI
 |-
-| document || Contiene la información más relevante del documento recibido<br/>Verifica el objeto [[API_laFactura.co:WebHook_Document|webhook document]]<br/><b>Solo si el documento fué aceptado por nosotros</b> || objeto || NO/SI</small>
+| document || Contiene la información más relevante del documento recibido<br/>Verifica el objeto '''[[API_laFactura.co:WebHook_Document|webhook document]]'''<br/><b>Solo si el documento fué aceptado por nosotros</b> || objeto || NO/SI</small>
 |}

@@ Línea 120: / Línea 120: @@
 | email->virus || Contiene si el correo contienes virus "false"/"true"  || cadena || SI
 |-
-| URL || URL dispuesta para descargar copia de los documentos recibidos en formato zip || cadena || SI
+| URL || URL dispuesta para descargar copia de los documentos recibidos en formato zip<br/><b>Solo si el documento fué aceptado por nosotros</b> || cadena || SI
 |-
-| document || Si el documento fué aceptado por nuestro sistema, contiene la información más relevante del documento recibido<br/>Verifica el objeto [[API_laFactura.co:WebHook_Document|webhook document]] || objeto || NO/SI</small>
+| document || Contiene la información más relevante del documento recibido<br/>Verifica el objeto [[API_laFactura.co:WebHook_Document|webhook document]]<br/><b>Solo si el documento fué aceptado por nosotros</b> || objeto || NO/SI</small>
 |}

@@ Línea 119: / Línea 119: @@
 |-
 | email->virus || Contiene si el correo contienes virus "false"/"true"  || cadena || SI
 |-
 | document || Si el documento fué aceptado por nuestro sistema, contiene la información más relevante del documento recibido<br/>Verifica el objeto [[API_laFactura.co:WebHook_Document|webhook document]] || objeto || NO/SI</small>
 |}

@@ Línea 120: / Línea 120: @@
 | email->virus || Contiene si el correo contienes virus "false"/"true"  || cadena || SI
 |-
-| document || Si el documento fué aceptado por nuestro sistema, contiene la información más relevante del documento recibido || objeto || NO/SI</small>
+| document || Si el documento fué aceptado por nuestro sistema, contiene la información más relevante del documento recibido<br/>Verifica el objeto [[API_laFactura.co:WebHook_Document|webhook document]] || objeto || NO/SI</small>
 |}

@@ Línea 100: / Línea 100: @@
 ! Parámetro !! Descripción !! Tipo !! Obligatorio
 |-
-| tascode || Identificador único, del documento del evento|| cadena || SI
+| type || Tiene el método por el cual nuestro sistema recibió el documento || cadena || SI
 |-
-| date || Fecha del evento<br><small>(YYYYMMDDHHMMSS) Ejemplo: 20210125102005</small> || cadena || SI
+| status || Estado del documento<br><small>2 - > Aceptado<br/>98 -> Rechazado</small> || cadena || SI
 |-
-| text || Información del evento en texto || cadena || SI
+| tascode || Código único del documento en nuestro sistema</small> || cadena || SI
 |-
-| alert || Alerta generada || cadena || SI
+| msg || Mensajes de error y/o advertencias encontradas por nuestro sistema || cadena || SI
 |-
-| process || Información del proceso<br/><small>Solo aparece cuando se trata de un cambio de estado del documento</small>  || objeto || NO
+| email->from || Correo recibido de este buzón || cadena || SI
 |-
-| process->change || Si cambió el estado del documento  (true/false) || boolean || SI
+| email->to || Buzón que recibió el correo || cadena || SI
 |-
-| process->newValue || El nuevo estado del documento (Solo si change=true)<br/><small>Estado de proceso:<br/>0 -> En cola <br/>1 -> En proceso DIAN<br/>2 -> Aceptado DIAN<br/>77/78 -> Reintentando<br/>Mayor que 90 -> Rechazado DIAN</small> || numerico || SI/NO
+| email->subject || Asunto enviado al correo || cadena || SI
 |-
-| email|| información de correo || cadena || NO
+| email->date || Fecha del recepción<br><small>(YYYYMMDDHHMMSS) Ejemplo: 20210125102005</small> || cadena || SI
 |-
-| email->email || correo electronico del evento || cadena || SI<br/><small>Solo si el evento es relacionado con correos</small>
+| email->spam || Contiene si el correo es considerado spam "false"/"true" || cadena || SI
 |-
-| email->status || Estado de transporte de correos<br/><small>0 -> Correo enviado<br/>1->correo recibido<br/>2->correo rechazado<br>97-> dominio bloqueado por inexistente o estar en lista negra<br/>98-> correo en lista negra || numerico || SI<br/><small>Solo si el evento es relacionado con correos</small>
+| email->virus || Contiene si el correo contienes virus "false"/"true"  || cadena || SI
 |-
-| accept || Estado de aceptacion de un documento por un cliente<br/><small>1 -> Aceptado<br/>2->Rechazado || numerico || SI<br/><small>Solo si el evento es relacionado con aceptacion o rechazo de documentos</small>
+| document || Si el documento fué aceptado por nuestro sistema, contiene la información más relevante del documento recibido || objeto || NO/SI</small>
 |}

@@ Línea 60: / Línea 60: @@
                       "id": "900900900",
                       "telephone": "212121",
-                      "email": "nicolas.pena@on2design.com"
+                      "email": "pepito@xxxy.com"
                   },
                   "totals": {