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 18 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. (Método sencillo y recomendado):<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>
−
* En el API v2.0 el punto de acceso es en ../invoice/<br/>
+
 
−
* En el API v3.0 el punto de acceso es en ../creditNote/<br/>
+
    Ingreso:   
−
<br/>
+
    <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''': [[API_LaFactura.co:NotaCredito|Nota Crédito]]</i>
+
<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"
 
       }
 
       }
 
   }
 
   }
Línea 25: Línea 31:
 
| tascode || Código único en nuestro sistema del documento a anular|| cadena || SI || v2.0 / v3.0
 
| 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 || v2.0 / v3.0
+
| 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 || v2.0 / 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
 +
 
|}
 
|}
 +
<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=====
Línea 46: Línea 59:
 
           "intID":"ii-nc-anula-v300",
 
           "intID":"ii-nc-anula-v300",
 
           "document":"CR-2092092",
 
           "document":"CR-2092092",
−
          "referal":"fc-54984309jtr0ret90jjrg",
 
 
           "CUDE":"0092183901238098123092109383403298409328490348903483094",
 
           "CUDE":"0092183901238098123092109383403298409328490348903483094",
 +
          "customer":"0",
 
           "process":"0",
 
           "process":"0",
 
           "retries":"0"
 
           "retries":"0"
Línea 58: 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»