Facturas
Marcar factura como pagada
Cambia el estado de una factura de "Facturada" a "Pagada" y registra los métodos de pago utilizados.
Autenticación requerida: Este endpoint requiere autenticación Bearer Token. Usar el campo tokenCurrent obtenido del servicio de login (/login) en el header: Authorization: Bearer {tokenCurrent}
Requisitos:
- La factura debe estar en estado "Facturada"
- Requiere caja registradora activa
- El usuario debe tener permisos para crear facturas
Proceso:
- Actualiza el estado de la factura a "Pagada"
- Registra métodos de pago con timestamp
- Actualiza estado de órdenes asociadas
- Envía a integraciones contables (Siigo, Loggro)
- Registra propinas y costos de entrega
Ejemplos de Uso
1. Pago en efectivo
{
"_id": "507f1f77bcf86cd799439020",
"paymentMethodValue": [
{
"paymentMethod": "507f1f77bcf86cd799439018",
"value": 45000
}
],
"tip": 5000
}
2. Pago mixto (efectivo + tarjeta)
{
"_id": "507f1f77bcf86cd799439021",
"paymentMethodValue": [
{
"paymentMethod": "507f1f77bcf86cd799439018",
"value": 20000
},
{
"paymentMethod": "507f1f77bcf86cd799439019",
"value": 25000
}
]
}
3. Actualizar información del cliente
{
"_id": "507f1f77bcf86cd799439022",
"paymentMethodValue": [
{
"paymentMethod": "507f1f77bcf86cd799439018",
"value": 30000
}
],
"client": {
"name": "Juan Pérez Actualizado",
"phone": "+57 300 123 4567",
"email": "juan.nuevo@email.com"
}
}
post/invoices/{id}/changeToPaid
Request
- Base URLhttps://api.pirpos.com
- URLhttps://api.pirpos.com/invoices/{id}/changeToPaid
- AuthHTTP bearer
Path parameters
idstring required
ID de la factura a marcar como pagada
Request body
Example request
{
"_id": "507f1f77bcf86cd799439020",
"paymentMethodValue": [
{
"paymentMethod": "507f1f77bcf86cd799439018",
"value": 45000
}
],
"tip": 5000,
"client": {
"name": "Juan Pérez",
"phone": "+57 300 123 4567",
"email": "juan@email.com",
"idType": "CC",
"idNumber": "123456789"
}
}Response
Factura marcada como pagada exitosamente
Example response
{
"_id": "507f1f77bcf86cd799439011",
"businessId": "507f1f77bcf86cd799439012",
"business": {
"name": "Restaurante El Buen Sabor",
"nit": "123456789-1",
"address": "Calle 123 #45-67"
},
"number": "FAC-001",
"invoicePrefix": "FAC",
"seq": 1,
"products": [
{
"name": "Hamburguesa Clásica",
"quantity": 2,
"price": 15000
}
],
"total": 35000,
"totalPaid": 35000,
"status": "Pagada",
"type": "Normal",
"table": {
"name": "Mesa 5"
},
"client": {
"name": "Juan Pérez",
"phone": "+57 300 123 4567"
},
"cashier": {
"name": "María González"
},
"paid": {
"paymentMethodValue": {
"paymentMethod": "Efectivo"
}
},
"eInvoice": {
"DIAN": {
"dianState": "00"
}
},
"externalIntegration": {
"siigo": {
"statusCode": 200
},
"loggro": {
"statusCode": 200
}
},
"createdOn": "2025-08-05T10:30:00.000Z",
"modifiedOn": "2025-08-05T10:30:00.000Z"
}Changes
No recorded changes to this operation across all 1 revision of this API.