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 16 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
 
|-
 
|-
| tascode || Código del documento en nuestro sistema al que desea generarle el evento<small><br/>Para 030,031,032 o 033 debe ser un documento recibido<br/>y Para 034 debe ser un documento enviado</small> || 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 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 || Nota adicional aclaratoria en el documento || cadena|| NO || v3.0
 
 
|}
 
|}
  
 
=====Resultados=====
 
=====Resultados=====
 
----
 
----
Devuelve un objeto '''[[API_laFactura.co:invoiceResult|radianResult]]''' con el resultado de la operación<br/>
+
Devuelve un objeto '''radianResult''' con el resultado de la operación<br/>
<i>Importante: Verifica toda la informacion que radianResult devuelve ingresando al objeto.</i>
+
 
  
 
   {
 
   {
Línea 80: Línea 86:
 
           "mode":"Creation",
 
           "mode":"Creation",
 
           "tascode":"rx-54984309jtr0ret90jjrg",
 
           "tascode":"rx-54984309jtr0ret90jjrg",
           "intID":"1",
+
           "intID":"1a22",
           "document":"RAD-212121",
+
           "document":"RAD-1234566",
 
           "CUFE":"43059843095203aa948093248093483048039248093403298409328490348903483094",
 
           "CUFE":"43059843095203aa948093248093483048039248093403298409328490348903483094",
 
           "process":"0",
 
           "process":"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"
       }
   }
 }