Integrare cu API Retur Simplu

Prin intermediul API-ului integrați simplu platforma dvs. cu Retur Simplu. Mai jos veți găsi toate datele necesare pentru integrare (implementare demonstrativă și endpoint-urile disponibile).

Pentru conectarea API-ului veți avea nevoie de numărul HID. Acesta este un identificator special care permite integrarea. Îl puteți obține contactând reprezentantul dvs. comercial. Dacă utilizați mai multe depozite pentru retururi, veți avea nevoie de mai multe numere HID, unul pentru fiecare depozit. În acest caz, întrebați reprezentantul dvs. comercial despre posibilitatea creării componentelor corespunzătoare în serviciul nostru.

Integrarea cu serviciul constă în transmiterea datelor din sistemul dvs. către API-ul nostru. În răspuns veți primi o adresă URL unică pentru client, unde va putea finaliza procesul de returnare fără să completeze din nou datele.

Implementare demonstrativă

Transmiterea datelor pentru returnare

POST https://api.retururisimple.ro/order/return-draft
Content-Type: application/json

{
  "mailboxHid": "ba16a1e4-11fb-411a-a7d0-fb697815c43f",
  "order": {
    "number": "2022231345",
    "client": {
      "name": "Ion Exemplu",
      "email": "[email protected]",
      "city": "București",
      "address": "Str. Exemplului 12",
      "postal_code": "010010",
      "phone": "+40 123 123 123"
    }
  }
}

{
  "hid": "ba16a1e4-11fb-411a-a7d0-fb697815c43f",
  "link": "https://retururisimple.ro/sklep?draft=2b600349-642b-4218-90fc-128c3a5e3f23"
}

{
  "errors": [
    {
      "message": "Lipsesc datele de intrare corespunzătoare",
      "code": "400",
      "level": "critical"
    }
  ],
  "mainError": {
    "message": "Lipsesc datele de intrare corespunzătoare",
    "code": "400",
    "level": "critical"
  },
  "failure": true,
  "successful": false
}