Endpoints de Invoice

Faturas são registros financeiros sincronizados do Stripe. Notas fiscais (NFSe) são documentos fiscais brasileiros emitidos via ISSNet (integração SOAP Brasilia/DF).

API de Invoice

Caminho base: /wp-json/middag-account/v1/invoices

Método	Endpoint	Auth	Escopo	Descrição
GET	/invoices	JWT + Org	finances	Listar faturas
GET	/invoices/{id}	JWT + Org	finances	Detalhes da fatura
GET	/invoices/{id}/pdf	JWT + Org	finances	Baixar PDF da fatura
GET	/invoices/order/{order_id}	JWT + Org	finances	Faturas vinculadas a um pedido

GET /invoices

Filtros de query: status (draft, open, paid, void, uncollectible), date_from, date_to.

Resposta (200):

{
    "success": true,
    "data": [
        {
            "id": 301,
            "status": "paid",
            "total": "1250.00",
            "currency": "BRL",
            "due_date": "2026-04-15",
            "paid_at": "2026-04-10T09:15:00Z",
            "order_id": 501,
            "stripe_invoice_id": "in_1abc2def3ghi"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 20,
        "total": 1,
        "pages": 1
    }
}

GET /invoices/:id/pdf

Retorna o PDF da fatura como download binario com Content-Type: application/pdf.

Endpoints de Nota Fiscal (NFSe)

Caminho base: /wp-json/middag-account/v1/tax-invoices

Método	Endpoint	Auth	Escopo	Descrição
GET	/tax-invoices	JWT + Org	finances	Listar NFSe
GET	/tax-invoices/{id}	JWT + Org	finances	Detalhes da NFSe
GET	/tax-invoices/{id}/pdf	JWT + Org	finances	Baixar PDF da NFSe
GET	/tax-invoices/order/{order_id}	JWT + Org	finances	NFSe vinculadas a um pedido

GET /tax-invoices

Filtros de query: status (pending, issued, cancelled, error).

Resposta (200):

{
    "success": true,
    "data": [
        {
            "id": 55,
            "status": "issued",
            "nfse_number": "2026000123",
            "total": "1250.00",
            "issued_at": "2026-04-12T10:00:00Z",
            "order_id": 501
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 20,
        "total": 1,
        "pages": 1
    }
}

Status de Invoice

Status	Descrição
draft	Fatura criada mas não finalizada
open	Finalizada e aguardando pagamento
paid	Pagamento recebido (terminal)
void	Anulada / cancelada (terminal)
uncollectible	Marcada como incobravel após tentativas falhas

Status de Nota Fiscal

Status	Descrição
pending	Aguardando emissão via ISSNet
issued	Emitida com sucesso com número de NFSe
cancelled	Cancelada no sistema municipal (terminal)
error	Emissão falhou -- retentativa via pending

Relacionados

• Endpoints de Order
• Labels de Status