Integrace dobropisů do Vašeho systému je možná zpracováváním webhooků o dobropisech. Aktivací rozšíření „Vlastní integrace dobropisů“ v Retinu (odkaz).
Instalace v Retinu
- Aktivujte si doplněk „Vlastní integrace dobropisů“ v nastavení fakturace.
- Přejděte na detail nově aktivovaného doplňku.
- Zadejte adresu, na kterou Vám máme zasílat webhooky o dobropisech.
Integrace na Vaší straně
Potřebujeme, abyste na adrese, kterou jste vložili ve 2. bodě, přijímali webhooky podle návodu Webhooky.
Tato data si můžete uložit a asynchronně do Retina odešlete soubor dobropisu vygenerovaného Vaším systémem přes endpoint našeho veřejného API.
Všechny odeslané požadavky jsou v Retinu dostupné v Retino – Nastavení webhooků v detailu konkrétního webhooky.
Formát dat
Níže je formát dat, který obsahuje požadavek webhooku, který budeme posílat na adresu Vašeho serveru.
{
"created_at": "2023-04-04T09:00:19.249525+00:00",
"event_type": "retino_credit_note.created",
"credit_note": {
"id": "5cae6caf-c1cb-49ed-96bd-2d2837765ffc",
"ticket_id": "5cae6caf-c1cb-49ed-96bd-2d2837765ffc",
"stock": true,
"currency": "CZK",
"language": "cs",
"order_id": "2022000001",
"variable_symbol": "2022000001",
"bank_account": {
"type": "CZECH_BANK_ACCOUNT",
"czech_bank_account": "123456789/0100"
},
"customer": {
"city": "Praha",
"name": "Jakub Novák",
"street": "Hradní",
"country": "CZ",
"postal_code": "11000",
"house_number": "1",
"company_id": "(ičo společnosti, může být prázdné)",
"company_vat_number": "(dič společnosti, může být prázdné)"
},
"lines": [
{
"id": "9ff867e8-7f90-4c54-9d65-9212ceceae76",
"name": "Macbook PRO",
"price": 39900,
"amount": 1,
"variant": "Space black",
"product_id": "MAC_PRO_2023"
}
]
}
}
Doručení webhooků
Webhooky pro dobropisy využívají náš standardní systém webhooků, který je detailně popsaný zde.
Vytváření dobropisů
Dobropisy se dají vytvářet v detailu případu v záložce Dobropis. Níže je náhled tohoto rozhraní:
