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.
+
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",
−
             "hash":"549115f582e4386f020705a29d79eaed",
+
             "intID":"int1",
 
             "description":"El cliente no aceptó el producto"
 
             "description":"El cliente no aceptó el producto"
 
       }
 
       }
Línea 11: Línea 21:
  
 
=====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
+
| 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 '''[[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 37: 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":"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 77: Línea 69:
  
 
==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 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»