Portal de proveedores

El Portal de proveedores es donde sus proveedores dan su alta, suben sus facturas (revisadas antes de llegar: SAT, 69-B, PUE o PPD, retenciones, tipo de cambio, orden de compra…) y ven cuándo se les paga. Con la API, su ERP (SAP, NetSuite, CONTPAQi o el suyo) recibe lo aprobado sin que nadie lo exporte a mano, y le devuelve a Fiscalisto la fecha de pago y el pago, que el proveedor ve en su portal.

• Un proveedor del portal (sup_…): su alta, sus documentos, la cuenta a la que se le paga y su calificación.
• Una factura de proveedor (spi_…): lo que se revisó, su orden de compra, su contrarecibo y sus fechas. Su estado: received (por revisar) → approved → scheduled → paid, o rejected.

La revisión y la aprobación (con sus niveles) se hacen en la app, en Compras › Portal de proveedores.

Su empresa de la appCopiar enlace a esta sección

Si su portal está en una empresa de la app (no en un emisor que creó con la API), conéctela a su cuenta API: en Desarrolladores › Emisores, en producción, pulse Conectar una empresa y elija la empresa y su RFC. Queda como un emisor más (iss_…, con source: "empresa") y estas rutas y sus eventos funcionan con su llave fk_live_. Es la misma empresa, no una copia. Con la API solo se usa su portal: cualquier otra ruta con ese emisor responde 403 issuer_linked_empresa. DELETE /v1/issuers/{id} la desconecta sin cambiar la empresa.

Las facturas aprobadasCopiar enlace a esta sección

Escuche supplier_invoice.approved en sus webhooks, o pida las aprobadas:

curl -G https://api.fiscalisto.com/v1/supplier_invoices \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -d status=approved

Cada una trae payable (lo que se le paga: el total sin las diferencias con su orden ni el descuento de pronto pago), due_on (cuándo vence por sus fechas de pago), purchase_order, contrarecibo y warnings (lo que se revisó y quedó como aviso). Su XML y su PDF están en GET /v1/sat_invoices/{sat_invoice}/xml y /pdf. Filtre también por supplier (sup_…) o received_since (AAAA-MM-DD).

Programar el pagoCopiar enlace a esta sección

El día en que la pagará. El proveedor lo ve en su portal y llega supplier_invoice.scheduled:

curl https://api.fiscalisto.com/v1/supplier_invoices/spi_OufpKqnrvx9p7Hq2mZr1XyT5uBcW8sKdLx/schedule \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "pay_on": "2026-11-27" }'

Solo una aprobada o ya programada, en una fecha de hoy en adelante. Si el SAT la reporta cancelada desde que se aprobó, responde 400 supplier_invoice_invalid y no se programa.

Marcar pagadaCopiar enlace a esta sección

Cuando su ERP o su banco la paga. Si es PPD, le pedimos al proveedor su complemento de pago (a más tardar el día 5 del mes siguiente) y llega supplier_invoice.paid:

curl https://api.fiscalisto.com/v1/supplier_invoices/spi_OufpKqnrvx9p7Hq2mZr1XyT5uBcW8sKdLx/mark_paid \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "paid_on": "2026-11-27", "reference": "SPEI 004512" }'

Fiscalisto no hace el pago: lo registra. paid_on es de hoy o antes.

Sus proveedoresCopiar enlace a esta sección

curl -G https://api.fiscalisto.com/v1/portal_suppliers \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -d status=approved

• status: invited, onboarding (dando su alta), in_review, approved (puede mandar facturas), rejected o suspended. Llega portal_supplier.approved cuando se aprueba un alta.
• bank_account: la CLABE a la que se le paga. Una nueva queda pending hasta que se aprueba en la app, que pide confirmar quién es; mientras, se le paga a previous_clabe. Así nadie cambia la cuenta de un proveedor sin que su equipo lo vea.
• documents: si su alta está completa y vigente, y cuántos documentos faltan, esperan revisión o vencieron.
• score: su calificación de 0 a 100 de los últimos 12 meses (excellent, good, fair o poor) y cada parte: invoices (facturas a la primera), deliveries (entregas a tiempo), prices (precio y cantidad de la orden), documents (documentos al día) y complements (complementos de pago), con cuántos casos se midió.

EventosCopiar enlace a esta sección

data.object es la factura de proveedor o el proveedor, como los da GET.