Алдын ала тапсырыс беру API

Клиенттік API біздің жүйеде алдын-ала тапсырыс жасау мүмкіндігін ұсынады.

Алдын ала тапсырыс беру - құру

Сұрау денесінде параметрлер жиынтығымен json preorder нысанын беру керек:

Сұрау мысалы:

Ішінде json объект:

        
{
  "preorder":
  {
    "sender":"Иванов Иван",
    "origin_region":"750000000",
    "origin_address":"Абая 153",
    "sender_phone":"+7(121)1234567",
    "receiver":"Петров Петр",
    "destination_region":"591010000",
    "destination_address":"Бокейханова 17",
    "weight":1.3,
    "client_code":"YOUR_ORDER_NUMBER",
    "customer_iin":"123456789012",
    "receiver_phone":"+7(121)1234567, +7 (727) 123-45-67",
    "comment":"Комментарий",
    "note":"Iphone X; Телефон",
    "quantity":2,
    "price": 400000,
    "desire_date":"2018-05-30"
  }
}
      
     

Сервердің жауабы:

        
{
  "preorder": {
    "id": 20,
    "waybill_name": "950562018985",
    "created_at": "2018-02-02T03:20:05.459Z",
    "link_to_pdf": "https://cabinet-api.exline.kz/storage/api/950562018985.pdf"
  }
}
        
      

Қателер

Төменде алдын ала өтінім жасауға тырысқан кездегі қателіктер тізімі берілген. Барлық қателер нысанда жіберіледі error.

1. 1. "error": "Wrong credentials (secret)" - қате secret немесе оның болмауы
2. 2. "error": "The :key must be a string.", "The :key field is required." - параметрлерді валидациялау, жарамсыздықтың параметрі мен түрі көрсетіледі
3. 3. "error": "origin_region_uniquness_violation" - КАТО коды бойынша 1-ден астам елді мекен табылды.
4. 4. "error": "destination_region_uniquness_violation" - КАТО коды бойынша 1-ден астам елді мекен табылды.
5. 5. "error": "origin_region_not_found" - КАТО коды бойынша бірде бір елді мекен табылған жоқ.
6. 6. "error": "destination_region_not_found" - КАТО коды бойынша бірде бір елді мекен табылған жоқ.
7. 7. "error": "customer_not_found" - ЖСН немесе БСН берілген төлеуші табылмады
8. 8. "error": "service_not_found" - егер қызмет берілсе, бірақ мұндай қызмет жоқ
9. 9. "error": "duplication_client_code_error" - мұндай нөмірмен алдын ала өтінім біздің жүйеде бұрыннан бар

Қателер

Төменде алдын ала өтінім жасауға тырысқан кездегі қателіктер тізімі берілген. Барлық қателер нысанда жіберіледі error.

1. 1. "error": "preorder_not_found" - мұндай клиент нөмірімен алдын ала тапсырыс табылмады
2. 2. "error": "preorder_already_completed" - алдын ала тапсырыс табылды, бірақ оның негізінде шот-фактура жасалды. Қызметкерлерге бұл тапсырысты жөнелтушіге қайтару қажет екендігі туралы хабарланады. Алдын ала өтінім мәртебесі қалады completed
3. 3. "error": "preorder_already_declined" - алдын ала тапсырыс табылды және мәртебесі бар отменен