Fiscal API

Documente fiscale native Monedo

Documentul fiscal și plata sunt obiecte diferite. Fiscal API păstrează factura, liniile, seria, XML-ul, statusul ANAF și documentele generate; Payments API păstrează încasarea și poate referi factura prin identificatorul extern.

POST

Fiscal API /invoices

fiscal:write

Creează factura, rezervă numărul atomic și calculează totalurile server-side.

POST

Fiscal API /invoices/{invoice}/send

fiscal:write

Programează independent PDF-ul, emailul și/sau transmiterea ANAF.

POST

Fiscal API /receipts

fiscal:write

Emite o chitanță fără să poată depăși soldul facturii.

GET

Fiscal API /deliveries/{delivery}

fiscal:read

Urmărește randarea, emailul sau transmiterea fiscală asincronă.

GET

Fiscal API /invoices?direction=issued

fiscal:read

Listează facturile emise și statusul lor fiscal.

GET

Fiscal API /invoices?direction=received

fiscal:read

Listează facturile primite și importate din e-Factura.

GET

Fiscal API /invoices/{invoice}

fiscal:read

Returnează antetul, liniile și ultima stare ANAF disponibilă.

Livrare explicită

Emailul și transmiterea ANAF sunt canale independente. API-ul nu trimite documentul nicăieri dacă proprietatea `delivery` lipsește.

import { MonedoFiscal } from '@monedo/fiscal';

const fiscal = new MonedoFiscal({ apiKey: process.env.MONEDO_API_KEY });
const invoice = await fiscal.forMerchant('BUSINESS_UUID').invoices.create({
  customer: { name: 'Client SRL', tax_id: 'RO12345678', email: 'facturi@client.ro' },
  lines: [{ description: 'Servicii', quantity: 1, unit_price: 100, vat_percent: 21 }],
  external_reference: 'order_1842',
  delivery: { render: true, email: { enabled: true } },
}, { idempotencyKey: 'invoice-order-1842' });

Descarcă Monedo Fiscal OpenAPI