Pornire rapidă

Cinci pași de la zero la prima dumneavoastră factură ca JSON. Aveți nevoie de un cont Ocost, ca proprietar sau contabil.

1. Înregistrați-vă

Înregistrați-vă la https://app.ocost.io/auth/sign-up sau conectați-vă. Fișierele trimise prin API apar în Fișiere, ca orice încărcare.

2. Creați o cheie

  1. Deschideți Setări › Dezvoltatori și alegeți Cheie nouă.
  2. Numiți cheia după cel care o folosește, de exemplu „Odoo producție”.
  3. Păstrați drepturile bifate și alegeți Creați cheia.
  4. Alegeți Copiați cheia. Cheia începe cu ocost_sk_, iar Ocost o arată o singură dată.

Păstrați-o în shell pentru pașii următori:

Shell
export OCOST_KEY="ocost_sk_…"

3. Trimiteți un PDF

Trimiteți fișierul ca multipart/form-data în câmpul file. external_ref este propriul dumneavoastră id, iar Ocost vi-l dă înapoi.

curl -sS https://api.ocost.io/public/v1/files \
  -H "Authorization: Bearer $OCOST_KEY" \
  -F "file=@invoice.pdf" \
  -F "external_ref=account.move,42"

Ocost răspunde 202 Accepted și începe citirea:

JSON
{
  "id": "01a1b08c-6e3a-7562-8f4a-7924722667b1",
  "name": "invoice.pdf",
  "status": "received",
  "reason": null,
  "external_ref": "account.move,42",
  "documents": [],
  "sha256": "0edd5593…"
}

4. Așteptați până este citit

Cereți fișierul la câteva secunde cât timp status este received sau reading. Majoritatea PDF-urilor durează sub un minut.

curl -sS https://api.ocost.io/public/v1/files/$FILE_ID \
  -H "Authorization: Bearer $OCOST_KEY"

Un fișier citit își listează documentele:

JSON
{
  "id": "01a1b08c-6e3a-7562-8f4a-7924722667b1",
  "status": "read",
  "documents": [
    {
      "id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11",
      "kind": "invoice",
      "number": "RE-2026-1187",
      "pages": [1]
    }
  ]
}

Un fișier care se încheie cu not_read sau failed spune motivul în reason. Stări și motive le listează.

5. Citiți documentul

Cereți primul document al fișierului.

curl -sS https://api.ocost.io/public/v1/files/$FILE_ID/document \
  -H "Authorization: Bearer $OCOST_KEY"

Răspunsul este factura ca ocost.document.v1, prescurtată aici:

JSON
{
  "schema": "ocost.document.v1",
  "kind": "invoice",
  "number": "RE-2026-1187",
  "issue_date": "2026-11-03",
  "due_date": "2026-12-03",
  "currency": "EUR",
  "seller": { "name": "Musterbüro Lieferant GmbH", "vat_id": "DE123456789" },
  "totals": { "net": 1068, "tax": 202.92, "gross": 1270.92 }
}

Mai departe

Vezi și