Kuenta Docs

Appearance

Obtener detalles de factura específica​

GET
/bill/{bill-id}

Recupera los detalles completos de una factura específica por su ID. Incluye información detallada del período de facturación, servicios utilizados, montos, estado de pago y enlaces de descarga.

Authorizations​

bearerAuth

JWT token de autenticación. Utilice este esquema para autenticar solicitudes con un token JWT.

TypeHTTP (bearer)

Parameters​

Path Parameters

bill-id*

ID único de la factura

Typestring
Required
Example456b7890-c123-45d6-e789-012345678901
formatuuid

Responses​

Detalles de la factura obtenidos exitosamente
application/json
JSON
{
"success": true,
"message": "success",
"data": {
"billId": "456b7890-c123-45d6-e789-012345678901",
"billNumber": "BILL-20240115-0001",
"subscriptionId": "123e4567-e89b-12d3-a456-426614174000",
"subscriptionDetails": {
"name": "Plan Empresarial Premium",
"planType": "enterprise",
"features": [
[
"Análisis de crédito ilimitado",
"Verificación de documentos",
"Soporte 24/7"
]
]
},
"billingPeriod": {
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"description": "Enero 2024",
"daysInPeriod": 31
},
"billDate": "2024-02-01",
"dueDate": "2024-02-15",
"status": "string",
"serviceBreakdown": [
{
"serviceId": "789f0123-4567-89ab-cdef-012345678901",
"serviceType": "credit_analysis",
"serviceName": "Análisis de Crédito Premium",
"category": "Core Services",
"usageDetails": {
"quantity": 150,
"includedQuantity": 100,
"overageQuantity": 50,
"unit": "análisis"
},
"pricing": {
"basePrice": "500000.00",
"unitPrice": "5000.00",
"overageAmount": "250000.00",
"totalAmount": "750000.00"
},
"period": "2024-01-01 al 2024-01-31"
}
],
"amounts": {
"subtotal": "1150000.00",
"discounts": {
"promotionalDiscount": "115000.00",
"loyaltyDiscount": "0.00",
"total": "115000.00"
},
"taxableAmount": "1035000.00",
"taxes": {
"vatAmount": "196650.00",
"vatRate": 19,
"otherTaxes": "0.00",
"totalTaxes": "196650.00"
},
"totalAmount": "1231650.00",
"currency": "COP"
},
"paymentInfo": {
"paymentDate": "2024-02-10T14:30:00Z",
"paymentMethod": "bank_transfer",
"transactionId": "TXN-240210-456789",
"paymentReference": "REF-240210-KUENTA-001",
"bankDetails": {
"bankName": "Banco de Bogotá",
"accountNumber": "****4567",
"transactionDate": "2024-02-10T14:30:00Z"
}
},
"organizationInfo": {
"organizationId": "789f0123-4567-89ab-cdef-012345678901",
"organizationName": "Fintech Innovadora S.A.S.",
"taxId": "900123456-7",
"contactInfo": {
"email": "[email protected]",
"phone": "+57 1 234 5678",
"address": "Calle 100 #15-20, Bogotá, Colombia"
}
},
"downloadUrls": {
"pdf": "https://api.kuenta.co/bills/456b7890-c123-45d6-e789-012345678901/pdf",
"xml": "https://api.kuenta.co/bills/456b7890-c123-45d6-e789-012345678901/xml",
"csv": "https://api.kuenta.co/bills/456b7890-c123-45d6-e789-012345678901/csv"
},
"auditTrail": [
{
"action": "bill_generated",
"timestamp": "2024-02-01T09:00:00Z",
"userId": "123e4567-e89b-12d3-a456-426614174000",
"details": "Factura generada automáticamente por el sistema"
}
],
"createdAt": "2024-02-01T09:00:00Z",
"updatedAt": "2024-02-10T14:30:00Z"
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI