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 54 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
−
==Anular factura==
+
==Objeto:deleteInvoice (Anular factura / Documento Soporte / Documento Equivalente)==
−
Si deseas anular una factura (Generar la nota crédito), puedes hacer la consulta usando DELETE en la URL del servicio e incluir el siguiente objeto.
+
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>
 +
 
 +
    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",
 +
            "intID":"int1",
 +
            "description":"El cliente no aceptó el producto"
 
       }
 
       }
 
   }
 
   }
 +
 +
=====Campos=====
 +
----
 +
Envía la información referente al documento a anular:
 +
 +
{| class="wikitable"
 +
|-
 +
! 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<br/><small>Si no lo envias .. generamos uno internamente (por compatilidad api 2.0)</small>|| cadena || NO || v3.0
 +
|-
 +
| hash || MD5 creado con el tascode+fecha de hoy (AAAAMMDD)<br><small>Ejemplo: "fc-54984309jtr0ret90jjrg20200321" = "549115f582e4386f020705a29d79eaed"<br/><b>Ya no es requerido</b></small> || cadena || NO || v2.0 / v3.0
 +
|-
 +
| description || Motivo por el cual se hace la anulacion de la factura || cadena || SI || 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 '''invoiceResult''' con el resultado de la operación que devuelve el documento generado como 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 21: Línea 55:
 
           "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":"1"
+
          "customer":"0",
 +
           "process":"0",
 +
          "retries":"0"
 
         }
 
         }
 
     }
 
     }
 
   }
 
   }
  
−
=====Objetos que emplea=====
+
=====A tener presente=====
−
*deleteInvoice: [[API_laFactura.co:verifyStatus|Verificar]]
+
* 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'''
−
*invoiceResult: [[API_laFactura.co:invoiceResult|Resultado Factura]]
+
 
 +
==Objetos Empleados==
 +
*invoiceResult: [[API_laFactura.co:invoiceResult|Resultado Documento Electrónico]]
  
 
==Temas complementarios==
 
==Temas complementarios==
 
* [[API_LaFactura.co:Facturacion|Facturación]]
 
* [[API_LaFactura.co:Facturacion|Facturación]]
 +
* [[API_LaFactura.co:NotaCredito|Nota Crédito]]
 +
 +
==Enlaces==
 +
*LaFactura.co: https://lafactura.co
 +
*GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
 +
 +
==Importante==
 +
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.<br>
 +
'''Si deseas tener un usuario y contraseña , comunícate con nosotros.'''

Revisión actual del 16:42 8 oct 2024

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"
      }
 }
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
hash MD5 creado con el tascode+fecha de hoy (AAAAMMDD)
Ejemplo: "fc-54984309jtr0ret90jjrg20200321" = "549115f582e4386f020705a29d79eaed"
Ya no es requerido		 cadena NO v2.0 / v3.0
description Motivo por el cual se hace la anulacion de la factura cadena SI 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=2772»