# Grupuri de firme
> Grupuri de firme: la ce societăți ajunge o cheie, antetul Ocost-Business, redirecționarea după identificatorii documentului, needs_company și fișierele din grup.
>
> Înainte: [Chei și drepturi](https://ocost.io/docs/ro/authentication.md)

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](https://app.ocost.io/settings/api). 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.

```bash
curl -sS https://api.ocost.io/public/v1/businesses \
  -H "Authorization: Bearer $OCOST_KEY"
```

```json
{
  "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.

```bash
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.

```json
{
  "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}`:

```bash
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:

```bash
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](https://ocost.io/docs/ro/mcp.md) 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.

## Vezi și

- [Chei și drepturi](https://ocost.io/docs/ro/authentication.md): Chei API: cum le poartă o cerere, înlocuirea lor, drepturile lor și refuzurile.
- [Stări și motive](https://ocost.io/docs/ro/statuses.md): Stările unui fișier și motivele pentru care nu a fost citit, și ce faceți în fiecare caz.
- [Documentul](https://ocost.io/docs/ro/document.md): Schema ocost.document.v1 în termenii EN 16931 (se mapează pe UBL și CII): un exemplu, tip și direcție, surse, verificări, versiuni și fiecare câmp și valoare.
- [Conectați un asistent](https://ocost.io/docs/ro/mcp.md): Conectați un asistent la serverul MCP (https://api.ocost.io/public/mcp, aceleași chei): Claude Code, Claude Desktop, Cursor, claude.ai și ChatGPT prin OAuth, și orice client.
