Pagos a proveedores

Cuentas por pagar (CxP): registra el dinero que le pagas a un proveedor y aplícalo contra una o varias compras o liquidaciones de compra (abono parcial o pago consolidado). Lo que no se aplica queda como anticipo al proveedor, y un pago también puede cancelarse con cruce contra cuentas contables en vez de caja o bancos. Espejo de Cobros sobre Compra en vez de Factura. Incluye la agenda de pagos semanal.

Registrar un pago

POST /api/v1/pagos-proveedor — Crea un pago y sus aplicaciones a compra(s)

Body

Forma de aplicaciones[]

import { Emitoo } from "emitoo";

const client = new Emitoo(); // lee la API key de EMITOO_API_KEY

const pago = await client.pagosProveedor.crear({
  proveedor_id: 7,
  fecha: new Date().toISOString(),
  medio: "01",
  monto: 320.0,
  referencia: "TRF-55021",
  aplicaciones: [
    { compra_id: 214, monto_aplicado: 200.0 },
    { compra_id: 219, monto_aplicado: 120.0 },
  ],
});

from emitoo import EmitooClient

client = EmitooClient()  # lee la API key de EMITOO_API_KEY

pago = client.pagos_proveedor.crear({
    "proveedor_id": 7,
    "fecha": "2026-07-06T09:30:00",
    "medio": "01",
    "monto": 320.00,
    "referencia": "TRF-55021",
    "aplicaciones": [
        {"compra_id": 214, "monto_aplicado": 200.00},
        {"compra_id": 219, "monto_aplicado": 120.00},
    ],
})

client, err := emitoo.New("") // lee la API key de EMITOO_API_KEY
if err != nil {
	log.Fatal(err)
}
ctx := context.Background()

pago, err := client.PagosProveedor.Crear(ctx, emitoo.M{
	"proveedor_id": 7,
	"fecha":        time.Now().Format(time.RFC3339),
	"medio":        "01",
	"monto":        320.0,
	"referencia":   "TRF-55021",
	"aplicaciones": []emitoo.M{
		{"compra_id": 214, "monto_aplicado": 200.0},
		{"compra_id": 219, "monto_aplicado": 120.0},
	},
})
if err != nil {
	log.Fatal(err)
}

curl -X POST https://api.emitoo.io/api/v1/pagos-proveedor \
  -H "X-API-Key: $EMITOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "proveedor_id": 7,
    "fecha": "2026-07-06T09:30:00",
    "medio": "01",
    "monto": 320.00,
    "referencia": "TRF-55021",
    "aplicaciones": [
      { "compra_id": 214, "monto_aplicado": 200.00 },
      { "compra_id": 219, "monto_aplicado": 120.00 }
    ]
  }'

Respuesta (201 Created)

{
  "id": 41,
  "fecha": "2026-07-06T09:30:00",
  "proveedor_id": 7,
  "medio": "01",
  "monto": 320.0,
  "referencia": "TRF-55021",
  "notas": null,
  "cuenta_dinero_id": null,
  "cruce_lineas": [],
  "monto_anticipo": 0,
  "saldo_anticipo": 0,
  "anulado": false,
  "anulado_motivo": null,
  "anulado_en": null,
  "creado_en": "2026-07-06T09:30:04",
  "aplicaciones": [
    { "id": 61, "compra_id": 214, "liquidacion_id": null, "monto_aplicado": 200.0, "desde_anticipo": false, "fecha_aplicacion": null },
    { "id": 62, "compra_id": 219, "liquidacion_id": null, "monto_aplicado": 120.0, "desde_anticipo": false, "fecha_aplicacion": null }
  ]
}

Errores

Listar pagos

GET /api/v1/pagos-proveedor?proveedor_id=&desde=&hasta=&limit=&offset= — Listado con filtros opcionales

Obtener un pago

GET /api/v1/pagos-proveedor/{id} — Detalle completo, con sus aplicaciones a compra

Anular un pago

POST /api/v1/pagos-proveedor/{id}/anular — Anula el pago y revierte sus aplicaciones (el saldo de las compras vuelve a subir)

Body

Cambiar la fecha de un pago

PATCH /api/v1/pagos-proveedor/{id}/fecha — Corrige la fecha del pago, de su egreso en el banco y de su asiento (sin rehacerlo)

{
  "fecha": "2026-09-28T09:30:00",
  "asiento_movido": true,
  "avisos": []
}

asiento_movido indica si el pago tenía asiento y se movió con él (mismo número). avisos lista efectos colaterales, por ejemplo que el egreso se desmarcó de una conciliación en curso porque la nueva fecha quedó después de su corte. Si parte del anticipo ya se aplicó, el pago no puede quedar después de esa aplicación. Las reglas comunes están en fechas contables: 400 por fecha inválida, 409 si el pago está anulado o el cambio toca una conciliación bancaria cerrada.

Pagos con cruce

Un pago con cruce cancela compras o liquidaciones contra una o varias cuentas contables en vez de caja o bancos. Caso típico: la factura del proveedor la pagó una compañía relacionada y el valor se carga a la cuenta por pagar a esa relacionada. No mueve dinero (no toca ninguna cuenta de dinero ni la conciliación bancaria) y genera el asiento Debe cuentas por pagar / Haber las cuentas del cruce.

Forma de cruce[]

Reglas del pago con cruce (si no se cumplen, 422):

• medio debe ser "15" (compensación de deudas) y no se envía cuenta_dinero_id.
• Σ cruce[].monto debe ser exactamente igual a monto, al centavo.
• Se aplica completo a documentos: aplicaciones no puede ir vacío y su Σ debe cuadrar con monto. Un cruce no deja anticipo.

Una cuenta que no existe en el plan, de agrupación, inactiva, de caja/bancos o igual a la cuenta por pagar que se cancela responde 400 con el número de línea. Se anula y se cambia de fecha igual que un pago normal.

curl -X POST https://api.emitoo.io/api/v1/pagos-proveedor \
  -H "X-API-Key: $EMITOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "proveedor_id": 7,
    "fecha": "2026-10-06T10:00:00",
    "medio": "15",
    "monto": 450.00,
    "referencia": "Pagada por Relacionada S.A.",
    "aplicaciones": [
      { "compra_id": 230, "monto_aplicado": 450.00 }
    ],
    "cruce": [
      { "cuenta_id": 2105, "monto": 450.00, "tercero_id": 31, "descripcion": "CxP a la relacionada" }
    ]
  }'

El pago trae las líneas en cruce_lineas:

"cruce_lineas": [
  {
    "id": 9,
    "cuenta_id": 2105,
    "cuenta_codigo": "201.03.02",
    "cuenta_nombre": "Cuentas por pagar relacionadas",
    "monto": 450.0,
    "tercero_id": 31,
    "tercero_nombre": "RELACIONADA S.A.",
    "descripcion": "CxP a la relacionada"
  }
]

Anticipos a proveedores

Un pago que entrega más de lo que aplica (o que va sin aplicaciones, antes de recibir la factura) deja la diferencia como anticipo: monto_anticipo es lo que quedó sin aplicar al crearlo y saldo_anticipo lo que falta aplicar. Contablemente es un activo (anticipos a proveedores) hasta que se aplica a una compra o liquidación del mismo proveedor. Aplicarlo baja el saldo del documento sin mover dinero y genera su propio asiento con la fecha de aplicación. Es el espejo de los anticipos de clientes.

Registrar un anticipo

curl -X POST https://api.emitoo.io/api/v1/pagos-proveedor \
  -H "X-API-Key: $EMITOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "proveedor_id": 7,
    "fecha": "2026-10-01T10:00:00",
    "medio": "20",
    "monto": 800.00,
    "referencia": "TRF-7781",
    "cuenta_dinero_id": 3,
    "aplicaciones": []
  }'

Registrar un anticipo emite el evento pago_proveedor.registrado de siempre; aplicarlo emite compra.pagada (o liquidacion.pagada) si el documento queda en cero. No hay eventos propios de anticipos.

Anticipos por aplicar

GET /api/v1/pagos-proveedor/anticipos?proveedor_id= — Pagos no anulados con saldo_anticipo > 0, del más antiguo al más reciente

[
  {
    "pago_id": 57,
    "fecha": "2026-10-01T10:00:00",
    "proveedor_id": 7,
    "proveedor_nombre": "Distribuidora Andina S.A.",
    "referencia": "TRF-7781",
    "monto_anticipo": 800.0,
    "saldo_anticipo": 500.0
  }
]

Aplicar un anticipo

POST /api/v1/pagos-proveedor/{id}/aplicar-anticipo — Aplica el anticipo del pago a compras o liquidaciones del mismo proveedor

{
  "fecha": "2026-10-06",
  "aplicaciones": [
    { "compra_id": 241, "monto_aplicado": 300.00 }
  ]
}

Devuelve el pago con la nueva aplicación (desde_anticipo: true y su fecha_aplicacion).

Deshacer una aplicación del anticipo

DELETE /api/v1/pagos-proveedor/{id}/aplicaciones/{aplicacion_id}?fecha= — Devuelve el saldo al documento y al anticipo, y revierte su asiento

Solo para aplicaciones hechas desde el anticipo (409 si la aplicación se hizo con el pago). fecha (query, opcional) es la del reverso del asiento; sin ella, la de la aplicación si su período sigue abierto. Devuelve el pago actualizado.

Agenda de pagos

GET /api/v1/pagos-proveedor/agenda — Compras con saldo pendiente, agrupadas por semana ISO (lunes) de fecha_vencimiento

Cada compra con saldo > 0 se agrupa en la semana (lunes ISO) de su fecha_vencimiento (o de fecha_emision si no tiene vencimiento). Útil para planificar los pagos de la semana.

{
  "semanas": [
    {
      "semana": "2026-07-06",
      "total": 320.0,
      "cantidad": 2,
      "compras": [
        {
          "id": 214,
          "numero_doc": "001-001-000000214",
          "proveedor_razon_social": "Distribuidora Andina S.A.",
          "fecha_vencimiento": "2026-07-08",
          "total": 200.0,
          "total_pagado": 0,
          "saldo": 200.0
        },
        {
          "id": 219,
          "numero_doc": "001-002-000000019",
          "proveedor_razon_social": "Suministros del Pacífico",
          "fecha_vencimiento": "2026-07-10",
          "total": 120.0,
          "total_pagado": 0,
          "saldo": 120.0
        }
      ]
    }
  ],
  "total_general": 320.0
}

Eventos

Este módulo emite los siguientes eventos:

// POST https://tu-app.com/webhooks/emitoo
// X-Emitoo-Event: pago_proveedor.registrado

{
  "evento": "pago_proveedor.registrado",
  "data": {
    "id": 41,
    "proveedor_id": 7,
    "medio": "01",
    "monto": 320.0,
    "referencia": "TRF-55021",
    "compras": [214, 219]
  }
}