Factuarea APIDevelopers
Contracte

Devolucions i import net dels cobraments no facturats

Els cobraments de Stripe que no es facturen porten les seves devolucions i l'import net que es queda el comerç, es poden filtrar per data i arriben a la gestoria en l'enviament trimestral com a CSV. Quatre operacions actualitzades i tres tools MCP actualitzades.

9 d'octubre de 2026 — Els cobraments que una regla de tractament deixa sense facturar mostren ara què ha passat amb ells després del cobrament, i arriben a la gestoria juntament amb les factures. Consulta Cobraments no facturats per veure el flux complet.

  • Devolucions i import net — cada cobrament no facturat retorna refunded_amount (import acumulat que Stripe ha retornat, devolucions completades i pendents, 0 si no n'hi ha), net_amount (amount menys refunded_amount, el que es queda el comerç) i refunded_at (data de l'última devolució, o null). Els tres imports fan servir el mateix format que amount. Una devolució pendent que acaba fallant o es cancel·la es torna a restar.
  • Filtre per data — el llistat de cobraments no facturats accepta occurred_from i occurred_to (YYYY-MM-DD, tots dos inclosos, segons la data del cobrament). Una data mal formada, o un occurred_to anterior a occurred_from, retorna 422.
  • En l'enviament trimestral — el ZIP trimestral i l'email a la gestoria afegeixen cobros_sin_factura_Q{quarter}_{year}.csv amb els cobraments del trimestre i les devolucions fetes en ell, amb totals per moneda. Cada devolució compta en el trimestre en què es produeix: quan el cobrament és d'un trimestre anterior, és una línia negativa que remet a aquell cobrament. include_non_invoiced_charges (booleà, true per defecte) deixa fora el fitxer quan és false. Un trimestre sense factures però amb aquests cobraments genera un ZIP només amb el CSV.
  • Trimestres per exportar — el llistat de trimestres disponibles retorna també els trimestres que només tenen cobraments no facturats o devolucions d'aquests, amb invoice_count 0 i el desglossament buit.
  • Tools MCP — list_stripe_non_invoiced_charges retorna els camps i filtres nous, quarterly_send_email accepta include_non_invoiced_charges i get_available_quarters llista els trimestres que només tenen cobraments no facturats.

Les integracions que no envien include_non_invoiced_charges reben el CSV sempre que el trimestre tingui cobraments no facturats.

Endpoints actualitzats4

EndpointDescripció
GET/v1/connected-accounts/{account}/non-invoiced-chargesLlistar els cobraments no facturats d'un compte de Stripe connectat
GET/v1/invoices/quarterly/available-quartersLlista els trimestres per exportar
POST/v1/invoices/quarterly/download-zipGenerar arxiu ZIP trimestral
POST/v1/invoices/quarterly/send-emailEnviar per email el ZIP trimestral a l'assessor