Послуга AllowedInspection (Огляд дозволено) (Молдова)

для клієнтського API v.1.0/shipments

Загальна інформація

Для внутрішніх відправлень по території Moldova (MD → MD) у клієнтському API доступна додаткова послуга AllowedInspection - право отримувача оглянути відправлення перед отриманням.

Послуга додається під час створення Shipment через:

POST /v.1.0/shipments

---

Як додати послугу

Для клієнтського API достатньо передати лише один параметр у блоці services:

"services": [ { "serviceCode": "AllowedInspection" } ]

Це є мінімально необхідний і достатній формат.

---

Що відбувається далі

Після отримання запиту API Gateway:

• автоматично доповнює сервіс технічними параметрами:

  • shipmentParcelRowNumber = null

  • amount = 1

  • contractNumber = null

  • payerType = "Sender"

  • additionalParameters = {}

• передає сформований об'єкт у внутрішню систему обробки відправлень

• не змінює передані клієнтом значення (якщо вони були вказані)

Бізнес-перевірки доступності послуги виконуються на стороні майстер системи - операційного модулю.

---

Приклад запиту

POST /v.1.0/shipments
Authorization: Bearer {token}
Content-Type: application/json

{
  "status": "ReadyToShip",
  "payerType": "Sender",
  "services": [
    {
      "serviceCode": "AllowedInspection"
    }
  ],
  "parcels": [
    {
      "cargoCategory": "documents",
      "rowNumber": 1,
      "insuranceCost": "15.00",
      "width": 250,
      "length": 350,
      "height": 20,
      "actualWeight": 1000
    }
  ],
  "sender": {
    "name": "Sender Name",
    "phone": "373XXXXXXXX",
    "countryCode": "MD",
    "settlementId": 123,
    "divisionId": 456
  },
  "recipient": {
    "name": "Recipient Name",
    "phone": "373XXXXXXXX",
    "countryCode": "MD",
    "settlementId": 123,
    "divisionId": 789
  }
}

---

Приклад відповіді (фрагмент)

"services": [
  {
    "serviceName": "AllowedInspection",
    "amount": 1,
    "payerType": "Sender",
    "paymentStatus": "FreeOfCharge",
    "price": 0,
    "cost": 0,
    "currencyCode": "MDL"
  }
]

---

Важливо

• Послуга доступна лише для внутрішніх відправлень по Молдові (MD → MD).

• Послуга є безкоштовною.

• Достатньо передати тільки "serviceCode": "AllowedInspection".

• Додаткові параметри передавати не потрібно.