Diferencia entre revisiones de «API LaFactura.co:Generar Factura»
Ir a la navegación
Ir a la búsqueda
| Línea 106: | Línea 106: | ||
*[[API_laFactura.co:exchangeRate|exchangeRate]] (Tasas) | *[[API_laFactura.co:exchangeRate|exchangeRate]] (Tasas) | ||
*[[API_laFactura.co:customer|customer]] (Cliente) | *[[API_laFactura.co:customer|customer]] (Cliente) | ||
| − | * | + | *[[API_laFactura.co:amounts|amounts]] (Montos) |
*taxes [[API_laFactura.co:taxes|Impuestos]] | *taxes [[API_laFactura.co:taxes|Impuestos]] | ||
*items [[API_laFactura.co:items|Lineas]] | *items [[API_laFactura.co:items|Lineas]] | ||
Revisión del 14:36 15 ene 2020
Sumario
Generar factura
Para generar una factura a través de la API y realizar los procesos de verificación, elaboracion, firmado y envío a la DIAN, debes realizar una petición POST, a la URL incluyendo el formato JSON con la información propia de la factura a ser generada.
Ejemplo
{
"invoice":
{
"rangeKey":"219832728",
"issueDate":"20200317",
"issueTime":"100521",
"dueDate" : "20200417",
"note1" : "Esta es una nota en la factura",
"customizationID" : "01",
"customer" : {
"additionalAccountID":"1",
"name":"Pepito Perez y Compania S.A.",
"countryName":"Colombia",
"countryCode":"CO",
"city":"Bogotá D.C.",
"countryEntity":"11",
"countrySubentity":"11001",
"addressLine":"Av 25 No. 8-47",
"documentNumber":"900900651",
"documentType":"31",
"telephone":"3112196952",
"email":"[email protected]"
},
"amounts":{
"totalAmount":"120000.00",
"taxAmount":"19000.00",
"payAmount":"139000.00"
},
"taxes":{
[
"ID":"IVA",
"taxableAmount":"100000.00",
"taxAmount":"19000.00",
"percent":"19.00"
]
},
"items":{
[
"quantity":"5.00",
"unitPrice":"20000.00",
"total":"100000.00",
"description":"Horas de soporte remoto",
"brand":"LF",
"model":"Soporte",
"taxes":{
[
"ID":"IVA",
"taxableAmount":"100000.00",
"taxAmount":"19000.00",
"percent":"19.00"
]
}
],
[
"quantity":"1.00",
"unitPrice":"20000.00",
"total":"20000.00",
"description":"Servicio sin IVA",
"brand":"LF",
"model":"Serv1",
]
}
}
}
Consulta todas las opciones de este objeto en invoice
Explicación
Se está solicitando la creación de una factura por un total de $139.000 Pesos, para el cliente Pepito Perez y Compañía SA, con:
- 5 Horas de soporte remoto con un costo unitario de $20.000, para un total de $100.000 + IVA ($19.000)
- 1 Hora de servicio sin IVA por un valor de $20.000
- El total antes de impuestos es de $120.000
- Los impuestos son: $ 19.000
- El total en factura en: $ 139.000
Resultados
Devuelve un objeto invoiceResult con el resultado de la operación
{
"invoiceResult":{
"status":{
"code":200,
"text":"Operación realizada con exito",
},
"document":{
"type":"Factura",
"mode":"Creation",
"tascode":"fc-54984309jtr0ret90jjrg",
"document":"FC-2092092",
"CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
"process":0
}
}
}
A tener presente
- El resultado incluye el campo "tascode", que es el codigo único interno en nuestro sistema e identifica el documento. Es requerido para cualquier acción posterior sobre este documento. (Es importante conservarlo)
- 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 adicionales empleados
- invoice (Factura)
- exchangeRate (Tasas)
- customer (Cliente)
- amounts (Montos)
- taxes Impuestos
- items Lineas
- allowance Descuentos y cargos
- invoiceResult (Resultado de la factura)