Notsy icon

Notsy

Issue Mexican CFDI 4.0 invoices, manage customers and read tax reports

Issue CFDI

AI-generated

Summary

Issues and stamps an official Mexican CFDI 4.0 invoice with the SAT by sending a POST to the Notsy API at /agent/facturas, using the line items, customer and payment details you provide.

Inputs

  • conceptos (required) — Line Items (JSON): array of CFDI conceptos. Each item has descripcion, clave_prodserv, clave_unidad, cantidad, valor_unitario and precio_incluye_iva. Sent as body property 'conceptos'.
  • cliente — Customer (JSON): recipient object with rfc, nombre, regimen_fiscal, cp and uso_cfdi (default G03). The field description says you can pass cliente_id of a saved customer instead (for example one from Create Customer). Sent as body property 'cliente'.
  • metodo_pago — SAT payment method: PUE (paid in a single payment, the default) or PPD (installments/credit).
  • forma_pago — SAT payment form code, default '03' (transfer). Other examples: 01 cash, 04 credit card.
  • requestOptions — Node settings for the HTTP request: batching (items per batch, interval), ignore SSL issues, proxy, timeout (default 10000 ms).

Output shape

The JSON response from the Notsy API for the issued invoice. The source does not define its fields, but the Invoice ID parameter description says the internal invoice ID comes from Issue CFDI, so the response presumably includes it.

The node has no custom execute code; it relies on declarative routing, so the response is returned as the API sends it. It requires notsyApi credentials. Issuing is a real stamping action, unlike Preview Invoice, which validates and calculates totals at no cost. An invoice stamped in error must be cancelled with Cancel CFDI.

Examples

Example 1: Invoice a client for one consulting service paid by bank transfer.

conceptos with one item (clave_prodserv 80101500, clave_unidad E48, cantidad 1, valor_unitario 1000); cliente with rfc, nombre, regimen_fiscal, cp, uso_cfdi G03; metodo_pago PUE; forma_pago 03.

Example 2: Issue a credit-sale invoice to be paid later.

Same conceptos and cliente, with metodo_pago PPD and forma_pago set to the applicable SAT code.

Example 3: Invoice a saved customer.

cliente set to a JSON object with the cliente_id returned by Create Customer; conceptos built from upstream data via expressions.

Links

Discussion