API LaFactura.co:Invoice
Sumario
Objeto:invoice
Es el objeto raiz, del sistema de envio de facturas de nuestra API, es importante respetar todos los elementos aquí contemplados.
Ejemplo
{
"invoice":
{
"rangeKey":"219832728",
"intID":"1",
"issueDate":"20200317",
"issueTime":"100521",
"dueDate" : "20200417",
"paymentType" : "2",
"paymentCode" : "1",
"note1" : "CIENTO TREINTA Y CUATRO MIL DOSCIENTOS CUARENTA PESOS",
"note2" : "Esta es una nota en la factura",
"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]",
"emailStyle":"0"
},
"amounts":{
"totalAmount":"120000.00",
"discountAmount":"4000.00",
"extraAmount":"0.00",
"taxAmount":"18240.00",
"payAmount":"134240.00"
},
"items":[
{
"quantity":"5.00",
"unitPrice":"20000.00",
"total":"96000.00",
"description":"Horas de soporte remoto",
"brand":"LF",
"model":"Soporte",
"standard": "999",
"agency": "990",
"code": "1000",
"allowance":[
{
"charge":"false",
"reasonCode":"11",
"description":"Es un super descuento por hoy",
"baseAmount":"100000.00",
"amount":"4000.00",
"percent":"4.00"
}
],
"taxes":[
{
"ID":"01",
"taxAmount":"18240.00",
"percent":"19.00"
}
]
},
{
"quantity":"1.00",
"unitPrice":"20000.00",
"total":"20000.00",
"description":"Servicio sin IVA",
"brand":"LF",
"model":"Serv1",
"standard": "999",
"agency": "990",
"code": "1001"
}
],
"additional":{
"payment":{
"link":"https://linkdepago.com/id=1",
"message":"PAGAR",
"color":"#496591"
}
}
}
}
Explicacion
Se está solicitando la creación de una factura por un total de $134.240 Pesos, para el cliente Pepito Perez y Compañía SA, con:
Item 1:
- 5 Horas de soporte remoto con un costo unitario de $20.000, para un total de $100.000
- A estas 5 horas se les hizo un descuento del 4% ($4.000), para un total de $96.000
- Se le aplicó el IVA al valor de la línea ($18.240)
Item 2:
- 1 Hora de servicio sin IVA por un valor de $20.000
Totales:
- El total antes de impuestos es de $116.000
- Los impuestos son: $ 18.240
- El total en factura en: $ 134.240
Adicionalmente en el correo enviado al cliente va un boton de "PAGAR", que lleva a un link. (Esta opción NO está disponible para todos los clientes)
Campos
| Parámetro | Descripción | Tipo | Obligatorio | Notas |
|---|---|---|---|---|
| rangeKey | Identificador único, del rango de facturación a ser usado Esta valor es el resultado del servicio: Obtener Rangos |
cadena | SI | |
| intID | Identificador único, de este documento en tu base de datos Esta valor se utiliza como control para evitar repetir documentos en el sistema |
cadena | SI | |
| issueDate | Fecha de la factura (YYYYMMDD) Ejemplo: 20200321 |
cadena | SI | |
| issueTime | Hora de facturacion (HHMMSS) Ejemplo: 175430 |
cadena | SI | |
| dueDate | Fecha de vencimiento (YYYYMMDD) Ejemplo: 20200421 |
cadena | SI | |
| paymentType | Tipo de pago Efectivo->1 / Credito->2 Por omisión el sistema supone Credito -> "2" |
cadena | NO | |
| paymentCode | Medio de pago Por omisión supone Instrumento No Definido -> "1" consultar tabla |
cadena | NO | |
| note1 | Valor de la factura en letras | cadena | SI | |
| note2 | Nota para ser agregada en la factura | cadena | NO | |
| note3 | Nota para ser agregada en la factura | cadena | NO | |
| note4 | Nota para ser agregada en la factura | cadena | NO | |
| period | Periodo de facturación Grupo adicional para informar un Periodo de facturación Ir a: period |
objeto | NO | |
| prepaid | Pagos anticipados Grupo adicional para informar un Pago Anticipado Ir a: prepaid |
objeto | NO | |
| exchangeRate | Tasas de cambio (Solo se requiere cuando se trata de una moneda diferente al Peso Colombiano) Ir a: exchangeRate |
objeto | NO | |
| customer | Datos del cliente Ir a: customer |
objeto | SI | |
| amounts | Totales del documento Ir a: amounts |
objeto | SI | |
| items | Líneas de la factura (Debe existir almenos una) Ir a: items |
objeto | SI | |
| additional | Objeto con elementos complementarios Relaciona elementos específicos para algunos clientes especiales Objetos: usuarios.ms |
objeto | SI |
Resultados
Devuelve un objeto invoiceResult con el resultado de la operación
Importante: Verifica toda la informacion que invoiceResult devuelve ingresando al objeto.
{
"invoiceResult":{
"status":{
"code":200,
"text":"Operación realizada con exito"
},
"documento":{
"type":"Factura",
"mode":"Creation",
"tascode":"fc-54984309jtr0ret90jjrg",
"intID":"1",
"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 empleados
- exchangeRate (Tasas - Para ventas en Dólares)
- customer (Cliente)
- amounts (Montos)
- items (Lineas de la factura)
Usado por
Los siguientes recursos:
Temas complementarios
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.
Si deseas tener un usuario y contraseña , comunícate con nosotros.
