Compras y Gastos

Gestión de compras y emisión de Factura de Sujeto Excluido (FSE/14). Este flujo es esencial para el control de inventario y cumplimiento fiscal con proveedores no inscritos.

POST /external/expenses

Factura de Sujeto Excluido (FSE)

La FSE se emite cuando el receptor realiza la compra. El sistema integrador debe calcular y enviar el 10% de Retención de Renta correspondiente en el campo totalRent.

Parámetros del Payload

Campo	Tipo	Descripción
branch_id	UUID	Sucursal que registra el gasto.
provider_id	UUID	ID del proveedor (Sujeto Excluido).
date	Date	Fecha de la transacción (YYYY-MM-DD).
payment_type	String	Valores: `01` (Cash), `02` (Check), `03` (Card).
invoiceProductsDetail	Array	Items comprados con `sku, quantity, description`.
totalRent	Number	Monto de Retención de Renta (10% sobre servicios).
batch_number	String	Número de lote para control de inventario.
expiration_date	Date	Fecha de vencimiento para productos perecederos.

HTTP 200

{
  "status": true,
  "message": "Expense created successfully",
  "data": {
    "expense_id": "uuid-gasto",
    "generation_code": "...",
    "total": 450.00,
    "status": "PROCESADO"
  }
}

HTTP 200 (Status Check)

{
  "status": true,
  "data": {
    "expense_id": "...",
    "document_type": "fse",
    "status": "PROCESADO",
    "provider": {
      "legal_name": "Proveedor Sujeto Excluido"
    },
    "totals": {
      "expense_to_payment": 450.00
    }
  }
}

HTTP 401

{ "error": "Unathorized" }

HTTP 500

{ "error": "Server error" }

Nota de Implementación: Al igual que en Ventas, este endpoint utiliza el campo status en la respuesta raíz para indicar el resultado de la operación.