Diferencia entre revisiones de «API LaFactura.co:Documentos ML»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
(Página creada con «==Objeto:getItem (Información de Documento)== Se utiliza para conocer todos los detalles de un correo recibido (aprobado o rechazado). Este servicio es por el método '''P…»)
 
Línea 91: Línea 91:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
|-
 
|-
−
| type || Tiene el método por el cual nuestro sistema recibió el documento || cadena || SI
+
| deliveryDate || Fecha de recepción del documento<br><small>(AAAA-MM-DD HH:MM:SS)</small> || cadena || SI
 
|-
 
|-
−
| status || Estado del documento<br><small>2 - > Aceptado<br/>98 -> Rechazado</small> || cadena || SI
+
| tascode || Identificador del documento en nuestro sistema || cadena || SI  
 
|-
 
|-
−
| tascode || Código único del documento en nuestro sistema</small> || cadena || SI
+
| mailbox || Buzon que envió el correo electrónico|| cadena || SI
 
|-
 
|-
−
| msg || Mensajes de error y/o advertencias encontradas por nuestro sistema || cadena || SI
+
| status || Si el documento se considera aceptado o rechazado por nuestro análisis || cadena || SI  
 
|-
 
|-
−
| email->from || Correo recibido de este buzón || cadena || SI
+
| message || Mensajes de error y/o advertencias sobre su rechazo o aceptacion despues del análisis || cadena || SI
 
|-
 
|-
−
| email->to || Buzón que recibió el correo || cadena || SI
+
| content || Contiene la información más relevante del documento recibido<br/>Verifica el objeto '''[[API_laFactura.co:Document_Mailer_CO|document]]'''<br/><b>Solo si el documento fué aceptado por nosotros</b> || objeto || NO/SI</small>
−
|-
 
−
| email->subject || Asunto enviado al correo || cadena || SI
 
−
|-
 
−
| email->date || Fecha del recepción<br><small>(YYYYMMDDHHMMSS) Ejemplo: 20210125102005</small> || cadena || SI
 
−
|-
 
−
| email->spam || Contiene si el correo es considerado spam "false"/"true" || cadena || SI
 
−
|-
 
−
| 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<br/><b>Solo si el documento fué aceptado por nosotros</b> || cadena || SI
 
−
|-
 
−
| events || Eventos registrados en RADIAN para este documento || cadena || SI
 
−
|-
 
−
| related || Información basica de los documentos encadenados a este en RADIAN.<br/>Incluye tipo de evento, número de documento, tascode y estado del documento etre otros.<br/><b>Puedes usarlo en conjunto con el servicio verifyStatus para ampliar la información que se tiene del documento en cuestion</b>  || cadena || SI
 
−
|-
 
−
| document || Contiene la información más relevante del documento recibido<br/>Verifica el objeto '''[[API_laFactura.co:WebHook_Document|document]]'''<br/><b>Solo si el documento fué aceptado por nosotros</b> || objeto || NO/SI</small>
 
 
|}
 
|}

Revisión del 09:50 4 dic 2025

Objeto:getItem (Información de Documento)

Se utiliza para conocer todos los detalles de un correo recibido (aprobado o rechazado). Este servicio es por el método POST 

    Ingreso:     
    https://***.tas-la.com/facturacion.v30/incoming/
     
    Solicita tu usuario y contraseña +57-601-7466664
    No cobramos por el proceso de pruebas o desarrollo
    Y puedes empezar inmediatamente (sin certificados o papeleos)



 {
      "getItem":{
           "tascode":"ml-89021930493049304903493049034-v32"
      }
 }
Objeto

Envía la solicitud:

Parámetro Descripción Tipo Obligatorio
tascode Código del documento recibido en nuestro sistema cadena SI
Resultados

Devuelve un objeto incomingResult con el resultado de la operación y la información referente. 

    {
         "mailerResult":{
             "status":{
                "code":200,
                "text":"Operación realizada con exito"
             }
             "document": {
                {
                  "deliveryDate": "2025-12-03 20:53:27",
                  "tascode": "mi-16f908c8318bcfca0983695e9bf25012-v32",
                  "mailbox": "[email protected]",
                  "from": "[email protected]",
                  "subject": "900219835;F21 Colombia;FC21;01;F21 S.A.S.",
                  "status": "accepted",
                  "message": "Validacion de correo OK"
                  "content":{
                      "document": {
                          "type": "fc",
                          "date": "20251201000000",
                          "num":  "TV432762510",
                          "cufe": "4853f347a6f964c805e100aee8ac3fbf11ccacf2ede9efbb0fcc0a7321c05fc8e355644edab7c284aa4315b82dd0b75e",
                          "event¨: null,
                          "json": "--- json to string  (base64) ----"
                      },
                      "provider": {
                          "name": "Camara de Comercio de Bogota",
                          "id": "860007322",
                          "type": "31",
                          "telephone": "5141000",
                          "email": "[email protected]"
                      },
                      "customer": {
                          "name": "Pepito Perez SA",
                          "id": "9009009001",
                          "type": "31",
                          "telephone": "5141001",
                          "email": "[email protected]"
                      },
                      "amounts": {
                          "LineExtensionAmount": "6500.00",
                          "TaxExclusiveAmount": "0",
                          "TaxInclusiveAmount": "6500.00",
                          "AllowanceTotalAmount": "0",
                          "ChargeTotalAmount": "0",
                          "PrepaidAmount": "0",
                          "PayableRoundingAmount": "0.0",
                          "PayableAmount": "6500.00"
                      },
                      "files":{
                          "z09002198340002500ddf8d6.zip":"--- (archivo base64) ---",
                           ----
                          "logo.png":"--- (archivo base64) ---"
                      }
                 }
          }
      }
Objeto:document
Parámetro Descripción Tipo Obligatorio
deliveryDate Fecha de recepción del documento
(AAAA-MM-DD HH:MM:SS)		 cadena SI
tascode Identificador del documento en nuestro sistema cadena SI
mailbox Buzon que envió el correo electrónico cadena SI
status Si el documento se considera aceptado o rechazado por nuestro análisis cadena SI
message Mensajes de error y/o advertencias sobre su rechazo o aceptacion despues del análisis cadena SI
content Contiene la información más relevante del documento recibido
Verifica el objeto document
Solo si el documento fué aceptado por nosotros		 objeto NO/SI
Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:Documentos_ML&oldid=3056»