A crédito
Esta sección describe los compos que podría contener la factura.
Método: POST
Endpoint
https://api-sandbox.factus.com.co/v2/bills/validatehttps://api.factus.com.co/v2/bills/validateEncabezados de la Solicitud
Para realizar la solicitud es necesario incluir los siguientes encabezados:
Content-Type : application/json Indica que los datos se envían en formato JSON. |
Authorization Bearer token_de_acceso Token de autenticación necesario para acceder al recurso. Ver Cómo generar token |
Accept : application/json Indica que la respuesta debe estar en formato JSON. |
Nota:
Reemplaza token_de_acceso con el token proporcionado tras autenticarte.
Ejemplo de Solicitud
Sección titulada «Ejemplo de Solicitud»{ "reference_code": "FACT-2026-0130", "document": "01", "numbering_range_id": 4, "operation_type": "10", "payment_details": [ { "payment_form": "2", "payment_method_code": "10", "reference_code": "pago-001", "amount": "50000", "due_date": "2026-03-25" }, { "payment_form": "1", "payment_method_code": "42", "reference_code": "pago-001", "amount": "83300" } ], "cash_rounding_amount": "0.00", "observation": "Observación de prueba", "customer": { "identification_document_code": "31", "identification": "123456789", "company": "Alan company name", "trade_name": "Alan trade name", "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization_code": "1", "tribute_code": "ZZ", "municipality_code": "68679" }, "items": [ { "code_reference": "PROD-000A", "name": "Producto A", "quantity": "1.00", "discount_rate": "0.00", "price": "10000.00", "unit_measure_code": "94", "standard_code": "999", "taxes": [ { "code": "01", "rate": "19.00" } ] }, { "code_reference": "PROD-000B", "name": "Producto B", "quantity": "3.00", "discount_rate": "0.00", "price": "20000.00", "unit_measure_code": "94", "standard_code": "999", "taxes": [ { "code": "01", "rate": "19.00" } ] } ]}Response
Sección titulada «Response»{ "status": "Created", "message": "Documento con el código de referencia FACT-2026-0130 registrado y validado con éxito", "data": { "reference_code": "FACT-2026-0130", "number": "SETP990001109", "document_type": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "10", "name": "Estándar" }, "payment_form": { "code": "2", "name": "Pago a crédito" }, "payment_method": { "code": "1", "name": "Medio de pago no definido" }, "order_reference": null, "billing_period": null, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 02:53:57 PM", "errors": null, "observation": "Observación de prueba", "payment_due_date": "14-02-2027", "created_at": "02-03-2026 02:53:56 PM", "numbering_range": { "prefix": "SETP", "from": 990000000, "to": 995000000, "resolution_number": "18760000001", "start_date": "19-01-2019", "end_date": "19-01-2030", "months": 132 }, "company": { "url_logo": "http://api.test/storage/images/logos/oCuCijLV5YQY6AGZjxFCafdWaWEgIBFBl7aWa3ok.png", "nit": "900825759", "dv": "7", "economic_activity": "6311", "establishment": { "name": "HALLTEC S.A.S.", "address": "Calle 11 # 8 - 84", "phone_number": "3161331234", "email": "email@gmail.com", "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } } }, "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "tribute": { "code": "ZZ", "name": "No aplica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "items": [ { "scheme_id": null, "note": "", "mandate": null, "additional_properties": [], "code_reference": "PROD-000A", "name": "Producto A", "quantity": "1.00", "unit_measure": { "code": "94", "name": "unidad" }, "standard_code": { "code": "999", "name": "Estándar de adopción del contribuyente" }, "discount_rate": "0.00", "discount": "0.00", "gross_value": "10000.00", "taxes": [ { "tribute": { "code": "01", "name": "IVA" }, "is_excluded": false, "rates": [ { "taxable_amount": "10000.00", "tax_amount": "1900.00", "rate": "19.00" } ] } ], "withholding_taxes": [], "price": "10000.00", "total": "11900.00" }, { "scheme_id": null, "note": "", "mandate": null, "additional_properties": [], "code_reference": "PROD-000B", "name": "Producto B", "quantity": "3.00", "unit_measure": { "code": "94", "name": "unidad" }, "standard_code": { "code": "999", "name": "Estándar de adopción del contribuyente" }, "discount_rate": "0.00", "discount": "0.00", "gross_value": "20000.00", "taxes": [ { "tribute": { "code": "01", "name": "IVA" }, "is_excluded": false, "rates": [ { "taxable_amount": "60000.00", "tax_amount": "11400.00", "rate": "19.00" } ] } ], "withholding_taxes": [], "price": "20000.00", "total": "71400.00" } ], "allowance_charges": [], "taxes": [ { "tribute": { "code": "01", "name": "IVA" }, "is_excluded": false, "rates": [ { "taxable_amount": "70000.00", "tax_amount": "13300.00", "rate": "19.00" } ] } ], "withholding_taxes": [], "totals": { "gross_value": "70000.00", "taxable_amount": "70000.00", "tax_amount": "13300.00", "discount_amount": "0.00", "surcharge_amount": "0.00", "total": "83300.00" }, "related_documents": [], "related_notes": { "credit_notes": [], "debit_notes": [] }, "cufe": "d9167c38ab41fc8b992a470f33e5d5ffc28abd7e71a4309d89c96e58f34a7e820d766c80005750cdabce3fb670ce8d6d", "links": { "qr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=d9167c38ab41fc8b992a470f33e5d5ffc28abd7e71a4309d89c96e58f34a7e820d766c80005750cdabce3fb670ce8d6d", "public_url": "http://app.test/documents/bills/bc62e12757ed5ca001279ced3f8647e8ac2e18862f8837b9ec0cd490a57bf5d0" } }}