Grupuri de firme
Un grup sunt societățile pe care un proprietar le conduce în Ocost. O singură cheie API poate trimite și citi pentru mai multe dintre ele. Această pagină spune la ce societăți ajunge o cheie și unde ajunge fiecare fișier.
La ce ajunge o cheie
O cheie aparține societății în care a fost creată, societatea ei de origine. Doar proprietarul îi dă alte societăți ale grupului în Setări › Dezvoltatori. Este o selecție sau toate, inclusiv cele adăugate mai târziu. Le poate stabili și suportul Ocost, iar fiecare schimbare apare în Setări. O cheie nouă ajunge doar la societatea ei de origine.
Cheia și secretul ei rămân aceleași când i se schimbă societățile. O societate la care nu mai ajunge este refuzată de la următoarea cerere. La fel o societate care părăsește grupul.
GET /public/v1/businesses listează societățile la care ajunge o cheie, întâi societatea de origine. Orice cheie poate întreba.
curl -sS https://api.ocost.io/public/v1/businesses \
-H "Authorization: Bearer $OCOST_KEY"{
"businesses": [
{ "id": "018f3c2a-7d1e-7b6a-9c40-2f5e8a1b3d77", "name": "Beispiel Holding GmbH", "own": true },
{ "id": "018f3c2a-9a04-7c21-8e5b-6d2f4c0a9e15", "name": "Beispiel Nord GmbH", "own": false },
{ "id": "018f3c2a-b5e7-7f42-9d13-4a8c2e6f1b09", "name": "Beispiel Süd GmbH", "own": false }
]
}Numiți societatea
Numiți societatea unei cereri cu antetul Ocost-Business, identificatorul ei. Antetul decide, iar Ocost nu redirecționează nimic. Fără el, cererea acționează în societatea de origine a cheii.
curl -sS https://api.ocost.io/public/v1/files \
-H "Authorization: Bearer $OCOST_KEY" \
-H "Ocost-Business: 018f3c2a-9a04-7c21-8e5b-6d2f4c0a9e15" \
-F "file=@invoice.pdf"Un fișier trimis astfel are routed_by: header. O societate la care cheia nu ajunge este refuzată cu 403 urn:ocost:key:business. Un antet care nu este un identificator dă 400.
Lăsați documentul să decidă
Trimiteți fără Ocost-Business, iar o cheie care ajunge la mai multe societăți redirecționează fișierul. Ocost îl stochează și îl citește în societatea de origine a cheii. Înainte să scrie ceva din citire, caută societățile grupului pe document.
Contează doar un identificator exact al unei societăți:
| Pe document | routed_by |
|---|---|
| Cod de TVA sau alt număr fiscal ori de firmă, precum un ІПН, un NIP, un EIN sau un IDNO | vat_id |
| Cod fiscal, de exemplu o Steuernummer | tax_number |
| ЄДРПОУ sau РНОКПП | edrpou |
| Număr de registru cu instanța sa | register |
| IBAN-ul societății, drept cont de plată | iban |
O factură primită numește societatea drept cumpărător, una emisă drept vânzător. Un contract poate numi oricare parte. Un număr citit cu îndoială nu contează niciodată. Nici un nume sau o adresă.
Numărul unei părți poate sta în afara blocului ei, ca în destinația plății "… для ТОВ «Приклад» 42135797" sau în subsol. Ocost îl atașează părții după care stă. Dacă nicio parte nu poartă numărul unei societăți, contează unul oriunde în text, niciodată al societății vânzătorului.
| Documentul numește | Fișierul |
|---|---|
| O societate prin identificatorul ei | Se mută acolo, cu routed_by ca mai sus |
| Nicio societate a grupului | Rămâne în societatea de origine a cheii, cu routed_by: home |
| Două societăți, sau alta doar prin nume | Așteaptă ca needs_company în societatea de origine |
Un fișier mutat își păstrează id-ul. Se numără la documentele lunii ale societății în care s-a mutat.
Atribuiți un fișier care așteaptă
Un fișier care așteaptă își listează candidates, fiecare cu why. Întâi vin societățile pe care le numește documentul, la final societatea de origine a cheii.
{
"id": "01a1b08c-6e3a-7562-8f4a-7924722667b1",
"status": "needs_company",
"business_id": "018f3c2a-7d1e-7b6a-9c40-2f5e8a1b3d77",
"routed_by": null,
"candidates": [
{ "business_id": "018f3c2a-9a04-7c21-8e5b-6d2f4c0a9e15", "name": "Beispiel Nord GmbH", "why": "vat_id" },
{ "business_id": "018f3c2a-b5e7-7f42-9d13-4a8c2e6f1b09", "name": "Beispiel Süd GmbH", "why": "vat_id" },
{ "business_id": "018f3c2a-7d1e-7b6a-9c40-2f5e8a1b3d77", "name": "Beispiel Holding GmbH", "why": "home" }
]
}În Ocost, proprietarul sau contabilul răspunde în Azi › Alocă. Sau răspundeți înainte cu PATCH /public/v1/files/{file_id}:
curl -sS -X PATCH https://api.ocost.io/public/v1/files/$FILE_ID \
-H "Authorization: Bearer $OCOST_KEY" \
-H "Content-Type: application/json" \
-d '{"business_id": "018f3c2a-9a04-7c21-8e5b-6d2f4c0a9e15"}'Orice răspuns pune routed_by: person. La societate trebuie să ajungă și cheia dumneavoastră, și cheia care a trimis fișierul. Un fișier care nu așteaptă dă 409.
Găsiți fișierele din grup
O cheie care nu numește nicio societate își găsește fișierele trimise în fiecare societate la care ajunge. GET /public/v1/files/{file_id}, conținutul și documentul lui merg doar cu id-ul fișierului. La fel DELETE.
GET /public/v1/files listează fișierele societății de origine și pe cele trimise de cheie în altă parte. business_id al fiecărui fișier spune unde este. Parametrul business_id le păstrează pe ale unei societăți:
curl -sS -G https://api.ocost.io/public/v1/files \
-H "Authorization: Bearer $OCOST_KEY" \
--data-urlencode "business_id=018f3c2a-9a04-7c21-8e5b-6d2f4c0a9e15"Aceiași octeți aflați deja într-o societate la care ajunge cheia răspund cu acel fișier. Ocost îi numără o dată.
MCP într-un grup
Serverul MCP primește aceleași chei și același antet. send_file fără Ocost-Business redirecționează ca mai sus. Orice alt instrument acționează în societatea pe care o numește antetul, altfel în societatea de origine a cheii. Fiecare apel rămâne la cheie, în societatea ei de origine, cu societatea în care a acționat.