Feronix Клиентский портал ATLAS

Клиентский API

Подключите вашу ERP-систему напрямую к Feronix — REST, JSON через HTTPS, привязка к арендатору, идемпотентность и предварительная проверка.

Данные, переданные через API, растаможиваются Feronix под собственной EORI и собственными счетами отсрочки. Вы как клиент передаёте данные поставок и отправок; Feronix осуществляет таможенную декларацию как декларант и представитель. Товары доставляются напрямую на склад Feronix.

Когда использовать API

Клиентский API — это путь для автоматизированной передачи из ERP-систем (SAP, Microsoft Dynamics, Odoo, Oracle) и для всех сценариев интеграции, в которых вы хотите автоматически передавать поставки, манифесты посылок, данные отправлений и документы. Он заменяет ручной ввод на портале и обеспечивает сквозную автоматизацию от ERP до таможни. Переданные поставки предназначены для склада Feronix; Feronix выступает как декларант и представитель в таможенной процедуре.

Поддерживаемые форматы ввода

  • Структурированные REST-пакеты — JSON через HTTPS
  • JSON — для отдельных данных и небольших пакетов
  • CSV — для массового импорта данных
  • Поставки NOVA-POSHTA — в формате NOVA строки товаров консолидируются по номеру посылки в физические посылки и их базовые товарные позиции

Конфликтующие мастер-данные посылок, дублирующиеся или отсутствующие назначения, недействительные суммы, вес, коды HS и компоненты адреса обнаруживаются до создания.

Аутентификация

curl -H 'X-Api-Key: ' \
     -H 'Accept-Language: de' \
     https://atlas.feronix.tech/customer/me

Ключ определяет арендатора на стороне сервера. customer_id в теле запроса никогда не должен расширять эту область. Поддерживаемые языки: de, en, fr, es, zh, ru, uk.

Чем вы можете управлять через API

  1. Создать поставку
  2. Передать данные поставки и транспорта
  3. Импортировать список посылок или товарный манифест
  4. Консолидировать посылки и товарные позиции
  5. Загрузить и назначить счета-фактуры, подтверждения стоимости, T1 и другие документы
  6. Получить результаты проверки
  7. Явно подать декларацию IMPOST
  8. Запросить статус, ошибки, сообщения и документы
  9. Исправить ошибочные данные и повторно отправить с новым номером сообщения

Рекомендуемая последовательность

  1. Определить случай T1 — если существует действующая транзитная процедура, сначала POST /warehouse/delivery-documents/t1. Если новый T1 должен быть создан, установите t1_mode=create в поставке.
  2. Создать поставку — POST /warehouse/delivery-manifests для поставки, включая срок и полный список посылок.
  3. Загрузить подтверждение стоимости — POST /warehouse/value-evidence для счёта-фактуры/подтверждения стоимости.
  4. Предварительная проверка — POST /customer/shipments/validate для предварительной проверки. Успешная проверка ничего не отправляет в таможню.
  5. Создать отправку — POST /customer/shipments для создания/отправки согласно телу запроса.
  6. Отслеживать статус — GET /customer/shipments/{lrn} и таможенный процесс через GET /customer/declarations/{lrn}.
  7. Сгенерировать T1 — с t1_mode=create после полного ввода сгенерируйте T1 через POST /warehouse/deliveries/{delivery_number}/t1-xml.

Идемпотентность

Ключи идемпотентности предотвращают дублирующее создание при сетевых или повторных попытках сканера. Логически идентичный повтор должен использовать тот же внешний ссылочный или идемпотентный идентификатор. Исправленная повторная отправка получает новый номер сообщения ATLAS. Тайм-аут — это не то же самое, что отказ — перед повторной попыткой проверьте, был ли запрос принят и только ответ был потерян.

Основные эндпоинты

МетодЭндпоинтНазначение
POST/warehouse/delivery-manifestsСоздать поставку и посылки атомарно (поставка на склад Feronix)
POST/warehouse/value-evidenceЗагрузить подтверждение стоимости
POST/customer/shipments/validateПредварительная проверка (ничего не отправляет в таможню)
POST/customer/shipmentsСоздать/отправить отправку
GET/customer/shipments/{lrn}Статус отправки
GET/customer/shipments/{lrn}/impost-xmlЭкспорт IMPOST-XML (ICOMDA)
GET/customer/shipments/{lrn}/standard-clearance/dossier.pdfPDF таможенного досье
GET/customer/shipments/{lrn}/standard-clearance/dossier.zipZIP таможенного досье
POST/customer/shipments/{lrn}/standard-clearance/atlas-xmlСгенерировать DECDFA-XML
GET/customer/declarations/{lrn}Таможенный процесс с сообщениями и решением
POST/customer/declarations/{lrn}/resubmitИсправленная повторная отправка
POST/customer/suma/xmlЭкспорт SumA-XML
POST/warehouse/transit-ordersСоздать транзитный заказ
POST/warehouse/transit-orders/{id}/xmlСгенерировать T1-XML (DETPDD)
POST/customer/customs-xml/validateПроверка XML по оригинальному XSD
GET/customer/meПрофиль арендатора
GET/customer/me/identitiesТаможенные идентичности (EORI/NL) — таможенные идентичности Feronix, под которыми Feronix выступает как декларант, а не ваши
GET/customer/me/mandatesМандаты на представительство — мандаты, под которыми Feronix выступает для вас как представитель в таможенной процедуре
GET/customer/reference/hs-searchПоиск кода HS

Коды ошибок

Ошибки API содержат HTTP-статус, стабильный код ошибки, локализованный текст и, по возможности, путь к затронутому полю.

СтатусЗначениеДействие
400Запрос технически нечитаемПроверьте JSON, кодировку или файл
401API-ключ отсутствует или недействителенОтправьте X-Api-Key правильного арендатора
403Отсутствует разрешениеПроверьте роль пользователя или одобрение API
404Объект не найден у арендатораПроверьте LRN, номер поставки, штрих-код и арендатора
409Логический конфликтИсправьте статус, уникальность или зависимые данные
422Нарушено обязательное поле/зависимостьПолностью обработайте подсказки по полям
500/502/503Техническая ошибкаНе отправляйте вслепую — повторите с тем же ключом идемпотентности
→ IMPOST Открыть счёт