┌────────────────┐     API REST      ┌────────────────┐     WSFE      ┌──────────┐
│   Tu ERP /     │ ──────────────→   │   Facturear    │ ──────────→   │  ARCA    │
│   Sistema de   │ ←──────────────   │   API          │ ←──────────   │  WSFE    │
│   Gestión      │   JSON + CAE      └────────────────┘   CAE         └──────────┘
└────────────────┘

{
  "cuit": "20123456789",
  "ptoVta": 1,
  "invoiceType": 6,
  "concepto": 2,
  "docTipo": 99,
  "docNro": 0,
  "condicionIVAReceptorId": 5,
  "clientName": "Consumidor Final",
  "impNeto": 100000,
  "impIVA": 21000,
  "impTotal": 121000,
  "iva": [
    { "id": 5, "baseImp": 100000, "importe": 21000 }
  ],
  "fchServDesde": "20260901",
  "fchServHasta": "20260930",
  "fchVtoPago": "20261010",
  "items": [
    {
      "description": "Producto o servicio",
      "quantity": 1,
      "unitPrice": 100000,
      "discount": 0,
      "ivaRate": 21,
      "subtotal": 100000
    }
  ]
}

# Ejemplo simplificado de módulo Odoo
import time
import requests

API = "https://www.facture.ar/api"

class AccountMove(models.Model):
    _inherit = 'account.move'

    def action_post(self):
        result = super().action_post()
        if self._es_factura_electronica():
            self._emitir_con_facturear()
        return result

    def _emitir_con_facturear(self):
        headers = {"x-api-key": self.company_id.facturear_api_key}
        payload = self._build_facturear_payload()  # campos como en el ejemplo de arriba

        response = requests.post(f"{API}/invoices", json=payload, headers=headers)
        response.raise_for_status()
        batch_id = response.json()["batchId"]

        # La emisión es asincrónica: consultar el lote hasta que termine
        while True:
            batch = requests.get(f"{API}/invoices/batches/{batch_id}", headers=headers).json()
            if batch["status"] in ("completed", "completed_with_errors", "error"):
                break
            time.sleep(2)

        item = batch["items"][0]
        if item["status"] != "completed":
            raise UserError(f"ARCA rechazó la factura: {item['responseBody']}")

        body = item["responseBody"]
        det = body["fecaesolicitarResult"]["FeDetResp"]["FECAEDetResponse"][0]
        self.write({
            'l10n_ar_afip_auth_code': det['CAE'],
            'l10n_ar_afip_auth_code_due': det['CAEFchVto'],  # YYYYMMDD
        })

const API = 'https://www.facture.ar/api';

async function emitirFactura(facturaData) {
  try {
    const response = await fetch(`${API}/invoices`, {
      method: 'POST',
      headers: { 'x-api-key': apiKey, 'Content-Type': 'application/json' },
      body: JSON.stringify(facturaData)
    });

    if (!response.ok) {
      const error = await response.json();
      // Registrar el error para revisión manual
      await registrarErrorFacturacion(facturaData, error);
      throw new Error(`Factura rechazada (${response.status}): ${error.error}`);
    }

    // La factura quedó encolada: guardá el batchId para consultar el CAE
    const { batchId } = await response.json();
    return batchId;

  } catch (err) {
    // No dejar facturas sin CAE sin registrar
    console.error('Error al emitir factura:', err);
    throw err;
  }
}