POST /v1/invoices

Issues a signed e-CF and submits it to DGII asynchronously.

Request

curl -X POST https://sandbox.api.erply.pro/v1/invoices \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @invoice.json

Required headers

Header	Notes
Authorization	Bearer <jwt> obtained from /v1/auth/token.
Idempotency-Key	UUID v4. TTL 24 h.
Content-Type	application/json; charset=utf-8.

Body

{
  "tenantId": "demo-rnc-131000001",
  "ecfType": "31",
  "encf": "E310000000001",
  "issueDate": "2026-05-01",
  "buyer": { "rnc": "131000002", "name": "Cliente Demo S.R.L." },
  "lines": [
    { "description": "Servicio", "qty": 1, "unitPrice": 5000.00, "taxRate": 0.18 }
  ],
  "subtotal": 5000.00,
  "tax": 900.00,
  "grandTotal": 5900.00
}

Responses

HTTP	Meaning
202 Accepted	Accepted, queued for DGII.
200 OK	Idempotent replay.

{
  "docId": "01HW9X4G…",
  "trackId": "20260501-DGII-9988",
  "status": "pending",
  "_links": {
    "self": "/v1/invoices/01HW9X4G…",
    "status": "/v1/invoices/01HW9X4G…/status"
  }
}

Possible errors

HTTP	Slug	Cause
400	malformed-json	Body is not JSON.
400	unsupported-ecf-type	Type outside the catalog.
400	validation-error	Pydantic failed.
401	unauthorised	Invalid token.
422	mathematical-discrepancy	Totals don't match.
422	tenant-config-missing	Missing RNC/PFX.
422	dgii-rejected (+ DGII code)	DGII rejection.
504	dgii-unavailable	DGII timeout.

See the full DGII error dictionary for the numeric codes.