Factuarea APIDevelopers
Contrato

Devoluciones e importe neto de los cobros no facturados

Los cobros de Stripe que no se facturan llevan sus devoluciones y el importe neto que se queda el comercio, se pueden filtrar por fecha y llegan a la gestoría en el envío trimestral como CSV. Cuatro operaciones actualizadas y tres tools MCP actualizadas.

9 de octubre de 2026 — Los cobros que una regla de tratamiento deja sin facturar muestran ahora qué pasó con ellos después del cobro, y llegan a la gestoría junto con las facturas. Consulta Cobros no facturados para ver el flujo completo.

  • Devoluciones e importe neto — cada cobro no facturado devuelve refunded_amount (importe acumulado que Stripe ha devuelto, devoluciones completadas y pendientes, 0 si no hay), net_amount (amount menos refunded_amount, lo que se queda el comercio) y refunded_at (fecha de la última devolución, o null). Los tres importes usan el mismo formato que amount. Una devolución pendiente que acaba fallando o se cancela se vuelve a restar.
  • Filtro por fecha — el listado de cobros no facturados acepta occurred_from y occurred_to (YYYY-MM-DD, ambos incluidos, según la fecha del cobro). Una fecha mal formada, o un occurred_to anterior a occurred_from, devuelve 422.
  • En el envío trimestral — el ZIP trimestral y el email a la gestoría añaden cobros_sin_factura_Q{quarter}_{year}.csv con los cobros del trimestre y las devoluciones hechas en él, con totales por moneda. Cada devolución cuenta en el trimestre en que ocurre: cuando el cobro es de un trimestre anterior, es una línea negativa que remite a ese cobro. include_non_invoiced_charges (booleano, true por defecto) deja fuera el fichero cuando es false. Un trimestre sin facturas pero con esos cobros genera un ZIP solo con el CSV.
  • Trimestres para exportar — el listado de trimestres disponibles devuelve también los trimestres que solo tienen cobros no facturados o devoluciones de ellos, con invoice_count 0 y el desglose vacío.
  • Tools MCP — list_stripe_non_invoiced_charges devuelve los campos y filtros nuevos, quarterly_send_email acepta include_non_invoiced_charges y get_available_quarters lista los trimestres que solo tienen cobros no facturados.

Las integraciones que no envían include_non_invoiced_charges reciben el CSV siempre que el trimestre tenga cobros no facturados.

Endpoints actualizados4

EndpointDescripción
GET/v1/connected-accounts/{account}/non-invoiced-chargesListar los cobros no facturados de una cuenta de Stripe conectada
GET/v1/invoices/quarterly/available-quartersLista los trimestres para exportar
POST/v1/invoices/quarterly/download-zipGenerar archivo ZIP trimestral
POST/v1/invoices/quarterly/send-emailEnviar por email el ZIP trimestral al asesor