Специальные услуги отправок

Специальные услуги добавляются на уровне коробки при создании отправки через мутацию shipmentCreateWorkflow. Используйте specialServices для объявления типа необходимой специальной обработки и specialServiceDetails для любой дополнительной конфигурации, требуемой этой услугой.

Поддержка перевозчика варьируется. Подтвердите у своего перевозчика, что выбранный уровень обслуживания поддерживает необходимую вам специальную услугу перед созданием отправки.

Батареи 

Используйте BATTERY в specialServices при отправке коробки, содержащей литий-ионные или литий-металлические батареи. Вы также должны предоставить batteryDetail внутри specialServiceDetails.

Примечание: batteryDetail должна быть внутри specialServiceDetails, а не передана непосредственно на коробку. Передача на уровне коробки приведет к ошибке проверки.

"shipmentCartons": [
  {
    "specialServices": ["BATTERY"],
    "specialServiceDetails": {
      "batteryDetail": {
        "material": "LITHIUM_ION",
        "packingType": "BATTERY_INSIDE_EQUIPMENT"
      }
    }
  }
]

Типы материала батареи:

• LITHIUM_ION — Литий-ионная батарея (перезаряжаемая)
• LITHIUM_METAL — Литий-металлическая батарея (неперезаряжаемая)

Типы упаковки батареи:

• BATTERY_INSIDE_EQUIPMENT — Батарея находится внутри предмета в посылке
• BATTERY_ONLY — Посылка содержит только батарею или батареи
• BATTERY_PACKAGED_WITH_EQUIPMENT — Батарея упакована с оборудованием, но не находится внутри него

Варианты подписи 

Используйте SIGNATURE_OPTION в specialServices, чтобы потребовать подпись при доставке. Предоставьте signatureOptionDetail внутри specialServiceDetails для указания типа подписи.

"shipmentCartons": [
  {
    "specialServices": ["SIGNATURE_OPTION"],
    "specialServiceDetails": {
      "signatureOptionDetail": {
        "signatureOptionType": "ADULT"
      }
    }
  }
]

Типы вариантов подписи:

• ADULT — Требуется подпись взрослого (получатель должен быть совершеннолетним)
• DIRECT — Требуется прямая подпись (кто-то по адресу должен подписать)
• INDIRECT — Косвенная подпись допускается (сосед или управляющий зданием может подписать)
• DEFAULT — Использует поведение по умолчанию для выбранного уровня обслуживания
• NONE — Подпись не требуется

Алкоголь 

Отправки алкоголя обрабатываются через функцию акцизов Zonos, которая рассчитывает применимые акцизные налоги на основе характеристик продукции, таких как объем и ABV. См. руководство по акцизам для настройки отправок алкоголя.

Сухой лед 

Используйте DRY_ICE в specialServices при отправке коробки, содержащей сухой лед в качестве охлаждающего агента. Предоставьте dryIceDetail внутри specialServiceDetails с весом сухого льда в коробке.

"shipmentCartons": [
  {
    "specialServices": ["DRY_ICE"],
    "specialServiceDetails": {
      "dryIceDetail": {
        "weight": 0.5,
        "weightUnit": "KILOGRAM"
      }
    }
  }
]

Опасные грузы 

Используйте DANGEROUS_GOODS в specialServices при отправке коробки, содержащей опасные материалы, требующие специальной обработки и документации перевозчика, помимо услуги батареи.

"shipmentCartons": [
  {
    "specialServices": ["DANGEROUS_GOODS"]
  }
]

Подробное руководство по отправке опасных материалов, включая ограничения по перевозчикам, см. в руководстве по отправке опасных грузов.

Объединение специальных услуг 

Несколько специальных услуг можно объединить в одной коробке, передав несколько значений в массиве specialServices.

"shipmentCartons": [
  {
    "specialServices": ["BATTERY", "SIGNATURE_OPTION"],
    "specialServiceDetails": {
      "batteryDetail": {
        "material": "LITHIUM_ION",
        "packingType": "BATTERY_INSIDE_EQUIPMENT"
      },
      "signatureOptionDetail": {
        "signatureOptionType": "DIRECT"
      }
    }
  }
]