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 URL
    https://api.pirpos.com
  • URL
    https://api.pirpos.com/invoices/{id}/changeToPaid
  • Auth
    HTTP bearer

Path parameters

idstring required

ID de la factura a marcar como pagada

Request body

_idstring required

ID de la factura (debe coincidir con el parámetro de la URL)

tipnumber

Propina otorgada (opcional)

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

_idstring

ID único de la factura

businessIdstring

ID del negocio al que pertenece la factura

numberstring

Número de la factura

invoicePrefixstring

Prefijo de la factura

seqnumber

Número secuencial de la factura

totalnumber

Total de la factura

totalPaidnumber

Total pagado

status'Pendiente' | 'Pagada' | 'Anulada'

Estado de la factura

type'Normal' | 'FacturaElectronica'

Tipo de factura

deliveryCostnumber

Costo de entrega

createdOnstring date-time

Fecha de creación

modifiedOnstring date-time

Fecha de última modificación

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.