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 24 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",
 +
                "cufe":"098234098234098320948320984928390328409283489023049890320892309843209832094832908423098409238448",
 +
                 "intID":"1a22",
 
                 "issueDate":"20220630",
 
                 "issueDate":"20220630",
 
                 "issueTime":"050000",
 
                 "issueTime":"050000",
Línea 36: 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
 
|-
 
|-
−
| 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
+
| 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
 
|-
 
|-
−
| tascode || Código del documento recibido en nuestro sistema al que desea generarle el evento || 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 47: Línea 53:
 
|-
 
|-
 
| issueTime || Hora de elaboración del documento (HHMMSS) || cadena || SI || v3.0
 
| issueTime || Hora de elaboración del documento (HHMMSS) || cadena || SI || 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
 
|-
 
|-
 
| 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
 
| 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
Línea 61: Línea 69:
 
|-
 
|-
 
| person->department || Departamento de la empresa donde labora la persona || cadena|| SI || v3.0
 
| person->department || Departamento de la empresa donde labora la persona || cadena|| SI || v3.0
−
|-
 
−
| note1 || Notas para agregar al documento || cadena || NO || v3.0
 
−
|-
 
−
| note2 || Notas para agregar al documento || cadena || NO || v3.0
 
−
 
 
|}
 
|}
  
 
=====Resultados=====
 
=====Resultados=====
−
Devuelve un objeto '''incomingResult''' con el resultado de la operación y la información referente.
+
----
−
 
+
Devuelve un objeto '''radianResult''' con el resultado de la operación<br/>
−
    {
+
 
−
          "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=====
+
  {
−
----
+
    "radianResult":{
−
{| class="wikitable"
+
        "status":{
−
|-
+
          "code":200,
−
! Parámetro !! Descripción !! Tipo !! Obligatorio
+
          "text":"Operación realizada con exito"
−
|-
+
        },
−
| type || Tiene el método por el cual nuestro sistema recibió el documento || cadena || SI
+
        "document":{
−
|-
+
          "type":"RADIAN",
−
| status || Estado del documento<br><small>2 - > Aceptado<br/>98 -> Rechazado</small> || cadena || SI
+
          "mode":"Creation",
−
|-
+
          "tascode":"rx-54984309jtr0ret90jjrg",
−
| tascode || Código único del documento en nuestro sistema</small> || cadena || SI
+
          "intID":"1a22",
−
|-
+
          "document":"RAD-1234566",
−
| msg || Mensajes de error y/o advertencias encontradas por nuestro sistema || cadena || SI
+
          "CUFE":"43059843095203aa948093248093483048039248093403298409328490348903483094",
−
|-
+
          "process":"0",
−
| email->from || Correo recibido de este buzón || cadena || SI
+
          "retries":"0"
−
|-
+
        }
−
| email->to || Buzón que recibió el correo || cadena || SI
+
    }
−
|-
+
  }
−
| 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>
 
−
|}
 

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»