Webhooky dobropisů

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

1. Aktivujte si doplněk „Vlastní integrace dobropisů“ v nastavení fakturace.
2. Přejděte na detail nově aktivovaného doplňku.
3. 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í: