Diferencia entre revisiones de «API LaFactura.co:EventosRadian»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
 
(No se muestran 38 ediciones intermedias del mismo usuario)
Línea 3: Línea 3:
 
<br><br>
 
<br><br>
 
     Ingreso:     
 
     Ingreso:     
−
     <nowiki>https://***.tas-la.com/facturacion.v30/radian/</nowiki>
+
     <nowiki>https://***.tas-la.com/facturacion.v30/radianEvents/</nowiki>
 
        
 
        
 
     <b>Solicita tu usuario y contraseña +57-601-7466664</b>
 
     <b>Solicita tu usuario y contraseña +57-601-7466664</b>
Línea 13: Línea 13:
 
           "event":{
 
           "event":{
 
                 "type":"030",
 
                 "type":"030",
−
"tascode":"em-1d7cb7e523e0e0db6912e630943de7fe-v300",
+
                "prefix":"RAD",
−
"intID":"1",
+
                "number":"1234566",
−
"issueDate":"20220630",
+
                "cufe":"098234098234098320948320984928390328409283489023049890320892309843209832094832908423098409238448",
−
"issueTime":"050000"
+
                "intID":"1a22",
 +
                "issueDate":"20220630",
 +
                "issueTime":"050000",
 +
                "person":{
 +
                    "docNum":"212121",
 +
                    "docType":"13",
 +
                    "firstName":"Pepito",
 +
                    "lastName":"Perez",
 +
                    "jobTitle":"Gerente",
 +
                    "department":"Gerencia"
 +
                }
 
           }
 
           }
 
     }
 
     }
Línea 28: Línea 38:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
|-
 
|-
−
| type || Código del tipo de evento a reportar<br/><small>030 -> Acuse de recibo de Factura Electrónica de Venta<br/>031 -> Reclamo de la Factura Electrónica de Venta<br/>032 -> Recibo del bien o prestación del servicio<br/>033 -> Aceptación expresa<br/>034 -> Aceptación tácita</small> || cadena || SI || v3.0
+
| mode || Método de verificación previa<br/><small>sync -> se verifica la existencia y estado del documento a procesar de inmediato (El tiempo de respuesta en la recepción depende del estado y velocidad de la DIAN)</br>async -> se procesa por colas y se retorna por webhooks la validacion del documento (recomendado)</small> <br/><b>Por omision: async</b>|| cadena || SI || v3.0
 
|-
 
|-
−
| tascode || Código del documento recibido en nuestro sistema al que desea generarle el evento || cadena || SI || v3.0
+
| type || Código del tipo de evento a reportar<br/><small>030 -> Acuse de recibo<br/>031 -> Reclamo<br/>032 -> Recibo del bien o prestación del servicio<br/>033 -> Aceptación expresa<br/>034 -> Aceptación tácita</small> || cadena || SI || v3.0
 +
|-
 +
| prefix || Prefijo del documento a generar || cadena || SI || v3.0
 +
|-
 +
| number || Número del documento a generar || cadena || SI || v3.0
 +
|-
 +
| cufe || CUFE/CUDE del documento al que desea generarle el evento || cadena || SI || v3.0
 
|-
 
|-
 
| intID || Código único de este documento en su sistema || cadena || SI || v3.0
 
| intID || Código único de este documento en su sistema || cadena || SI || v3.0
Línea 38: Línea 54:
 
| issueTime || Hora de elaboración del documento (HHMMSS) || cadena || SI || v3.0
 
| issueTime || Hora de elaboración del documento (HHMMSS) || cadena || SI || v3.0
 
|-
 
|-
−
| note1 || Notas para agregar al documento || cadena || NO || v3.0
+
| rejectCode || Código correspondiente al tipo de rechazo<br/><small><b>Solo Para:</b><br/>031 -> Reclamo de la Factura Electrónica de Venta<br/><b>Códigos:</b><br/>01-> Documento con inconsistencias<br/>02->Mercancía no entregada totalmente<br/>03->Mercancía no entregada parcialmente<br/>04->Servicio no prestado</small>|| cadena || NO || v3.0
−
|-
 
−
| note2 || Notas para agregar al documento || cadena || NO || v3.0
 
−
 
 
−
|}
 
−
 
 
−
=====Resultados=====
 
−
Devuelve un objeto '''incomingResult''' con el resultado de la operación y la información referente.
 
−
 
 
−
    {
 
−
          "incomingResult":{
 
−
              "status":{
 
−
                "code":200,
 
−
                "text":"Operación realizada con exito"
 
−
              }
 
−
              "incoming": {
 
−
                  "type": "email",
 
−
                  "status": "2",
 
−
                  "tascode": "em-86ba3cewrowerpoweor44casasebdc042febbbbbf31bd0083-v300",
 
−
                  "msg": "Att: firma en modo estricto -2-",
 
−
                  "URL": "http:\/******************************",
 
−
                  "email": {
 
−
                      "from": "[email protected]",
 
−
                      "to": "[email protected]",
 
−
                      "subject": "Fwd: El asunto",
 
−
                      "date": "20220629114359",
 
−
                      "spam": "false",
 
−
                      "virus": "false"
 
−
                  },
 
−
                  "document": {
 
−
                      "general": {
 
−
                          "type": "fc",
 
−
                          "mode": "1",
 
−
                          "num": "TV432762510",
 
−
                          "cufe": "4857f347a6f964c805e100aee8ac3fbf11ccacf2ede9efbb0fcc0a7321c05fc8e355644edab7c284aa4315b82dd0b75e",
 
−
                          "json": "--- json to string ----"
 
−
                      },
 
−
                      "provider": {
 
−
                          "name": "Camara de Comercio de Bogota",
 
−
                          "id": "860007322",
 
−
                          "telephone": "5941000",
 
−
                          "email": "[email protected]"
 
−
                      },
 
−
                      "totals": {
 
−
                          "LineExtensionAmount": "6500.00",
 
−
                          "TaxExclusiveAmount": "0",
 
−
                          "TaxInclusiveAmount": "6500.00",
 
−
                          "AllowanceTotalAmount": "0",
 
−
                          "ChargeTotalAmount": "0",
 
−
                          "PrepaidAmount": "0",
 
−
                          "PayableRoundingAmount": "0.0",
 
−
                          "PayableAmount": "6500.00"
 
−
                      }
 
−
                  }
 
−
          }
 
−
      }
 
−
 
 
−
=====Objeto:received=====
 
−
----
 
−
{| class="wikitable"
 
 
|-
 
|-
−
! Parámetro !! Descripción !! Tipo !! Obligatorio
+
| person || Contiene la informacion correspondiente a la persona que solicita el evento<br/><small><b>Solo Para:</b><br/>030 -> Acuse de recibo de Factura Electrónica de Venta<br/>032 -> Recibo del bien o prestación del servicio<br/></small> || objeto || NO || v3.0
 
|-
 
|-
−
| type || Tiene el método por el cual nuestro sistema recibió el documento || cadena || SI
+
| person->docNum || Nombre de la persona || cadena|| SI || v3.0
 
|-
 
|-
−
| status || Estado del documento<br><small>2 - > Aceptado<br/>98 -> Rechazado</small> || cadena || SI
+
| person->docType || Tipo de documento de la persona || cadena|| SI || v3.0
 
|-
 
|-
−
| tascode || Código único del documento en nuestro sistema</small> || cadena || SI
+
| person->firstName || Nombre de la persona || cadena|| SI || v3.0
 
|-
 
|-
−
| msg || Mensajes de error y/o advertencias encontradas por nuestro sistema || cadena || SI
+
| person->lastName || Apellido de la persona || cadena|| SI || v3.0
 
|-
 
|-
−
| email->from || Correo recibido de este buzón || cadena || SI
+
| person->jobTitle || Cargo de la persona || cadena|| SI || v3.0
 
|-
 
|-
−
| email->to || Buzón que recibió el correo || cadena || SI
+
| person->department || Departamento de la empresa donde labora la persona || cadena|| SI || v3.0
−
|-
 
−
| 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
 
−
|-
 
−
| 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>
 
 
|}
 
|}
 +
 +
=====Resultados=====
 +
----
 +
Devuelve un objeto '''radianResult''' con el resultado de la operación<br/>
 +
 +
 +
  {
 +
    "radianResult":{
 +
        "status":{
 +
          "code":200,
 +
          "text":"Operación realizada con exito"
 +
        },
 +
        "document":{
 +
          "type":"RADIAN",
 +
          "mode":"Creation",
 +
          "tascode":"rx-54984309jtr0ret90jjrg",
 +
          "intID":"1a22",
 +
          "document":"RAD-1234566",
 +
          "CUFE":"43059843095203aa948093248093483048039248093403298409328490348903483094",
 +
          "process":"0",
 +
          "retries":"0"
 +
        }
 +
    }
 +
  }

Revisión actual del 16:03 18 jul 2025

Objeto:event (Evento RADIAN)

Se utiliza para enviar los Eventos Básicos de RADIAN. Este servicio es por el método POST 

    Ingreso:     
    https://***.tas-la.com/facturacion.v30/radianEvents/
     
    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)



    {
         "event":{
               "type":"030",
               "prefix":"RAD",
               "number":"1234566",
               "cufe":"098234098234098320948320984928390328409283489023049890320892309843209832094832908423098409238448",
               "intID":"1a22",
               "issueDate":"20220630",
               "issueTime":"050000",
               "person":{
                   "docNum":"212121",
                   "docType":"13",
                   "firstName":"Pepito",
                   "lastName":"Perez",
                   "jobTitle":"Gerente",
                   "department":"Gerencia" 
               }
         }
    }


Objeto

Envía la solicitud:

Parámetro Descripción Tipo Obligatorio API
mode Método de verificación previa
sync -> se verifica la existencia y estado del documento a procesar de inmediato (El tiempo de respuesta en la recepción depende del estado y velocidad de la DIAN)
async -> se procesa por colas y se retorna por webhooks la validacion del documento (recomendado)
Por omision: async		 cadena SI v3.0
type Código del tipo de evento a reportar
030 -> Acuse de recibo
031 -> Reclamo
032 -> Recibo del bien o prestación del servicio
033 -> Aceptación expresa
034 -> Aceptación tácita		 cadena SI v3.0
prefix Prefijo del documento a generar cadena SI v3.0
number Número del documento a generar cadena SI v3.0
cufe CUFE/CUDE del documento al que desea generarle el evento cadena SI v3.0
intID Código único de este documento en su sistema cadena SI v3.0
issueDate Fecha de elaboración del documento (AAAAMMDD) cadena SI v3.0
issueTime Hora de elaboración del documento (HHMMSS) cadena SI v3.0
rejectCode Código correspondiente al tipo de rechazo
Solo Para:
031 -> Reclamo de la Factura Electrónica de Venta
Códigos:
01-> Documento con inconsistencias
02->Mercancía no entregada totalmente
03->Mercancía no entregada parcialmente
04->Servicio no prestado		 cadena NO v3.0
person Contiene la informacion correspondiente a la persona que solicita el evento
Solo Para:
030 -> Acuse de recibo de Factura Electrónica de Venta
032 -> Recibo del bien o prestación del servicio
 objeto NO v3.0
person->docNum Nombre de la persona cadena SI v3.0
person->docType Tipo de documento de la persona cadena SI v3.0
person->firstName Nombre de la persona cadena SI v3.0
person->lastName Apellido de la persona cadena SI v3.0
person->jobTitle Cargo de la persona cadena SI v3.0
person->department Departamento de la empresa donde labora la persona cadena SI v3.0
Resultados

Devuelve un objeto radianResult con el resultado de la operación


 {
   "radianResult":{
       "status":{
          "code":200,
          "text":"Operación realizada con exito"
       },
       "document":{
          "type":"RADIAN",
          "mode":"Creation",
          "tascode":"rx-54984309jtr0ret90jjrg",
          "intID":"1a22",
          "document":"RAD-1234566",
          "CUFE":"43059843095203aa948093248093483048039248093403298409328490348903483094",
          "process":"0",
          "retries":"0"
       }
   }
 }
Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:EventosRadian&oldid=2877»