Diferencia entre revisiones de «API LaFactura.co:Anular Factura»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
 
(No se muestran 31 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
−
==Objeto:deleteInvoice (Anular factura)==
+
==Objeto:deleteInvoice (Anular factura / Documento Soporte / Documento Equivalente)==
−
Si deseas anular una factura (Generar la nota crédito por el total del documento), puedes hacer la consulta usando '''DELETE''' en la URL del servicio e incluir el siguiente objeto.<br/><br/>
+
Si deseas generar nota credito total a una factura o a un Documento Soporte o a En Documento Equivalente, puedes hacer la solicitud usando '''POST''' en la URL del servicio e incluir el siguiente objeto. (Método sencillo y recomendado):<br><br>
−
<i>*Importante: Adicionalmente, puedes hacer '''Notas Crédito Parciales''': [[API_LaFactura.co:NotaCredito|Nota Crédito]]</i>
+
 
 +
    Ingreso:   
 +
    <nowiki>https://***.tas-la.com/facturacion.v30/creditNote/</nowiki>
 +
     
 +
    <b>Solicita tu usuario y contraseña +57-601-7466664</b>
 +
    No cobramos por el proceso de pruebas o desarrollo
 +
    Y puedes empezar inmediatamente (sin certificados o papeleos)
 +
<br>
 +
 
 +
<i>*Importante: Adicionalmente, puedes hacer '''Notas Crédito Parciales / Documentos de Ajuste Soporte / Documentos Equivalentes''': [[API_LaFactura.co:NotaCredito|Nota Crédito]]</i>
  
 
   {
 
   {
 
       "deleteInvoice":{
 
       "deleteInvoice":{
 
             "tascode":"fc-54984309jtr0ret90jjrg",
 
             "tascode":"fc-54984309jtr0ret90jjrg",
−
             "hash":"549115f582e4386f020705a29d79eaed",
+
             "intID":"int1",
−
             "description":"El cliente no aceptó el producto"
+
             "description":"El cliente no aceptó el producto",
 +
            "prefix":"NTC"
 
       }
 
       }
 
   }
 
   }
  
 
=====Campos=====
 
=====Campos=====
 +
----
 
Envía la información referente al documento a anular:
 
Envía la información referente al documento a anular:
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
−
! Parámetro !! Descripción !! Tipo !! Obligatorio
+
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
|-
 
|-
−
| tascode || Código único en nuestro sistema del documento a anular|| cadena || SI
+
| tascode || Código único en nuestro sistema del documento a anular|| cadena || SI || v2.0 / v3.0
 
|-
 
|-
−
| hash || MD5 creado con el tascode+fecha de hoy (AAAAMMDD)<br><small>Ejemplo: "fc-54984309jtr0ret90jjrg20200321" = "549115f582e4386f020705a29d79eaed"</small> || cadena || SI
+
| intID || Código único del documento a ser generado en tu sistema<br/><small>Si no lo envias .. generamos uno internamente (por compatilidad api 2.0)</small>|| cadena || NO || v3.0
 
|-
 
|-
−
| description || Motivo por el cual se hace la anulacion de la factura || cadena || SI
+
| description || Motivo por el cual se hace la anulacion de la factura || cadena || SI || v2.0 / v3.0
 +
|-
 +
| prefix || Prefijo del rango de Notas Crédito que desea usar, en caso de no enviarse se buscará el primero en automático disponible en el sistema || cadena || NO || v2.0 / v3.0
 +
 
 
|}
 
|}
 +
<span style="color:#009999"><b>Notas para migrantes de API v2.0 a v3.0:</b></span>
 +
----
 +
* El contenido es el mismo pero cambia el punto de ejecucion del objeto de ../invoice a ../creditNote<br/>
 +
<br/>
  
 
=====Resultados=====
 
=====Resultados=====
 +
----
 
Devuelve un objeto '''[[API_laFactura.co:invoiceResult|invoiceResult]]''' con el resultado de la operación y la información referente a la Nota Crédito
 
Devuelve un objeto '''[[API_laFactura.co:invoiceResult|invoiceResult]]''' con el resultado de la operación y la información referente a la Nota Crédito
  
Línea 38: Línea 57:
 
           "mode":"Creation",
 
           "mode":"Creation",
 
           "tascode":"nc-54984309jtr903840932480",
 
           "tascode":"nc-54984309jtr903840932480",
−
           "referal":"fc-54984309jtr0ret90jjrg",
+
           "intID":"ii-nc-anula-v300",
 
           "document":"CR-2092092",
 
           "document":"CR-2092092",
 
           "CUDE":"0092183901238098123092109383403298409328490348903483094",
 
           "CUDE":"0092183901238098123092109383403298409328490348903483094",
−
           "process":"0"
+
          "customer":"0",
 +
           "process":"0",
 +
          "retries":"0"
 
         }
 
         }
 
     }
 
     }
 
   }
 
   }
−
 
−
=====Objeto:document=====
 
−
Información referente al documento al que se hace relación:
 
−
 
−
{| class="wikitable"
 
−
|-
 
−
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
−
|-
 
−
| type || Tipo de documento: "Factura" ó "Nota Credito" || cadena || SI
 
−
|-
 
−
| mode || Resultado por "Creation"->Creación / "Verify"->Verificación || cadena || SI
 
−
|-
 
−
| tascode || Código interno del documento generado (Requerido para posteriores acciones)|| cadena || SI
 
−
|-
 
−
| referal || Código de documento enlazado (Una nota crédito o factura a este documento) || cadena || NO
 
−
|-
 
−
| document || Número de la Factura o Nota Credito || cadena || SI
 
−
|-
 
−
| CUFE || Código único de la factura DIAN || cadena || Solo en facturas
 
−
|-
 
−
| CUDE || Código único de documento electrónico DIAN || cadena || Solo en Notas Crédito
 
−
|-
 
−
| process || Estado de proceso 0 -> Enviando / 1 -> Verificando / 2 -> Aceptado DIAN // Mayor que 90 -> Rechazado DIAN || cadena || SI
 
−
|-
 
−
| URL || Dirección para descarga de la factura aceptada por la DIAN (formato ZIP) || cadena || Solo si está Aceptado por la DIAN
 
−
|-
 
−
| CHECK || Dirección para descarga de los resultados del documento en la DIAN (formato ZIP) || cadena || Solo si está aceptado por la DIAN
 
−
|}
 
  
 
=====A tener presente=====
 
=====A tener presente=====
Línea 78: Línea 71:
  
 
==Objetos Empleados==
 
==Objetos Empleados==
−
*invoiceResult: [[API_laFactura.co:invoiceResult|Resultado Factura]]
+
*invoiceResult: [[API_laFactura.co:invoiceResult|Resultado Documento Electrónico]]
  
 
==Temas complementarios==
 
==Temas complementarios==

Revisión actual del 14:17 16 abr 2026

Objeto:deleteInvoice (Anular factura / Documento Soporte / Documento Equivalente)

Si deseas generar nota credito total a una factura o a un Documento Soporte o a En Documento Equivalente, puedes hacer la solicitud usando POST en la URL del servicio e incluir el siguiente objeto. (Método sencillo y recomendado):

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


*Importante: Adicionalmente, puedes hacer Notas Crédito Parciales / Documentos de Ajuste Soporte / Documentos Equivalentes: Nota Crédito 

 {
      "deleteInvoice":{
           "tascode":"fc-54984309jtr0ret90jjrg",
           "intID":"int1",
           "description":"El cliente no aceptó el producto",
           "prefix":"NTC"
      }
 }
Campos

Envía la información referente al documento a anular:

Parámetro Descripción Tipo Obligatorio API
tascode Código único en nuestro sistema del documento a anular cadena SI v2.0 / v3.0
intID Código único del documento a ser generado en tu sistema
Si no lo envias .. generamos uno internamente (por compatilidad api 2.0)		 cadena NO v3.0
description Motivo por el cual se hace la anulacion de la factura cadena SI v2.0 / v3.0
prefix Prefijo del rango de Notas Crédito que desea usar, en caso de no enviarse se buscará el primero en automático disponible en el sistema cadena NO v2.0 / v3.0

Notas para migrantes de API v2.0 a v3.0:

  • El contenido es el mismo pero cambia el punto de ejecucion del objeto de ../invoice a ../creditNote


Resultados

Devuelve un objeto invoiceResult con el resultado de la operación y la información referente a la Nota Crédito 

 {
   "invoiceResult":{
       "status":{
          "code":"200",
          "text":"Operación realizada con exito",
       },
       "document":{
          "type":"Nota Credito",
          "mode":"Creation",
          "tascode":"nc-54984309jtr903840932480",
          "intID":"ii-nc-anula-v300",
          "document":"CR-2092092",
          "CUDE":"0092183901238098123092109383403298409328490348903483094",
          "customer":"0",
          "process":"0",
          "retries":"0"
       }
   }
 }
A tener presente
  • No se debe considerar un documento como válido por la DIAN, hasta que el resultado de una verificación del documento, muestre a process con: 2

Objetos Empleados

Temas complementarios

Enlaces

Importante

Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.
Si deseas tener un usuario y contraseña , comunícate con nosotros.

Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:Anular_Factura&oldid=3165»