Pro vývojáře (API)Pro

API: Odběratelé

Čtení, zakládání a úprava odběratelů, párování podle externího ID.

Odběratele načteš GET /odberatele, založíš POST /odberatele a upravíš PATCH /odberatele/{id}. Povinný je jen nazev; volitelně IČO, DIČ, e-mail, adresa, zeme a externiId.

POST /odberatele

curl -X POST https://zafakturujto.cz/api/v1/odberatele \
  -H "Authorization: Bearer fakt_TVUJ_KLIC" \
  -H "Content-Type: application/json" \
  -d '{ "nazev": "Firma s.r.o.", "ico": "12345678", "email": "fakturace@firma.cz" }'

Při vytváření faktury můžeš odběratele zadat rovnou v těle (objekt odberatel) — spáruje se, nemusíš ho zakládat zvlášť.

Párování odběratele

Zadáš	Co se stane
`externiId`	Najde se odběratel s tímto externím ID a jeho údaje se přepíšou na zaslané — doklad ponese aktuální jméno a adresu. Když externí ID ještě nikdo nemá, převezme ho odběratel nalezený podle IČO nebo e-mailu, který vlastní externí ID nemá; jinak se založí nový.
jen IČO nebo e-mail	Páruje se podle IČO, pak podle e-mailu. Existující odběratel se nemění.

Při přepisu i v PATCH se mění jen zaslaná pole. Pole s hodnotou null se vymaže, chybějící pole zůstává. Doklady vystavené dřív si drží svůj snímek odběratele a nemění se.

Idempotence

POST /odberatele se stejným externiId nevytvoří duplicitu — vrátí existujícího odběratele beze změny s HTTP 200 a jizExistoval: true.