malinoto/tracepass-mcp-server

GS1 EPCIS 2.0: события цепочки поставок. export входит в тарифы Starter и выше; для capture, capture_job и query требуется платный модуль EPCIS (без него эти действия возвращают сообщение в стиле 403). Действия (передаются через action, с args): - export — args: { id }. Экспортирует события паспорта в виде документа EPCIS 2.0 JSON-LD. Только чтение. - export_by_serial — args: { serial, gtin? }. То же, что и export, но по вашему собственному серийному номеру. Серийный номер уникален только В ПРЕДЕЛАХ GTIN; если в вашем аккаунте он не уникален, вызов возвращает 409 ambiguous_serial. Передайте gtin (или используйте export по id). Только чтение. - capture — args: { events }. events - это EPCISDocument, одно событие или массив событий (JSON-LD). Возвращает 202 с captureJobId. - capture_job — args: { jobId }. Опрашивает асинхронное задание capture. Только чтение. - query — args: { params? }. params - это карта «ключ/значение» со стандартными параметрами запроса EPCIS (EQ_bizStep, GE_eventTime, MATCH_epc, ...). Только чтение.

Обновляет значения полей в цифровом паспорте продукта. Каждое изменение записывается в журнал аудита паспорта и помечается как обновление через API-ключ. Действия (передаются через action, с args): - update - аргументы: { id, fieldKey, value }. Тип value соответствует dataType поля (string, number, boolean, array, object). - update_by_serial - аргументы: { serial, fieldKey, value, gtin? }. То же, что update, но адресуется по вашему serial. Серийный номер уникален только В ПРЕДЕЛАХ GTIN: если он не уникален в вашем аккаунте, вызов возвращает 409 ambiguous_serial; передайте gtin (или используйте update по id), чтобы точно разрешить неоднозначность.

Управляет сторонами-экономическими операторами на паспорте: manufacturer, importer, authorisedRepresentative, distributor, recycler, producerResponsibilityOrg. Каждая сторона имеет юридическое название и, в идеале, валидированный 13-значный GS1 GLN. Действия (передаются через action, с args): - set: args: { id, role, legalName, gln?, country?, legacyOperatorId? }. Устанавливает или обновляет одну роль. - remove: args: { id, role }. Очищает одну роль.

Управляет цифровыми паспортами продуктов: создает, читает и запускает действия жизненного цикла. ВАЖНО: create занимает слот DPP в тарифном плане аккаунта и ТАРИФИЦИРУЕТСЯ. Создание паспорта сверх включенной квоты влечет плату за каждый дополнительный паспорт; при превышении квоты инструмент возвращает сообщение вида 402: повторно запускайте только с args.confirmOverage=true после того, как пользователь явно согласится на плату. archive НЕОБРАТИМ (публичный QR-код навсегда возвращает 404); предпочитайте suspend, если изменение может быть отменено. Действия (передаются через action, с args): - list: args: { page?, limit? (≤100), productId?, status?, search? }. status ∈ draft|in_review|approved|published|suspended|expired|archived. Только чтение. - get: args: { id, format? (summary|full), lang? }. Только чтение. - get_by_serial: args: { serial, format?, lang?, gtin? }. Только чтение. Обращается к паспорту по вашему собственному серийному номеру. Серийный номер уникален только В ПРЕДЕЛАХ GTIN: если один и тот же серийный номер существует под двумя GTIN в вашем аккаунте, вызов возвращает 409 ambiguous_serial; передайте gtin (или используйте действие by-id), чтобы точно разрешить. - compliance: args: { id }. Только чтение. Возвращает трехуровневый вердикт о соответствии (compliant | compliant_with_warnings | incomplete) с заключениями, ссылающимися на нормативные акты: используйте его для сверки паспорта с правилами его категории, исправьте указанные поля/стороны, затем проверьте снова. - registry_readiness: args: { id }. Только чтение. Возвращает { ready, findings[] }: пройдет ли паспорт ФОРМАЛЬНУЮ проверку подачи в EU DPP Registry (обязательные поля заполнены, правильное форматирование, доступная публичная ссылка, гранулярность на уровне единицы товара через серийный номер и корректно сформированный товарный код, если категория его требует). Это механическая предварительная проверка реестра, а НЕ содержательный вердикт о соответствии; паспорт может быть готов к регистрации, но не соответствовать по существу. Только для батарейных паспортов. - create: args: { productId, gtin, serialNumber, confirmOverage? }. ТАРИФИЦИРУЕТСЯ. - suspend: args: { id }. Обратимо: публичный QR-код показывает…

Управляет каталогом продуктов TracePass. Продукт — это слой каталога: один продукт может иметь множество паспортов (один на сериализованную единицу). Продукты сами по себе не тарифицируются. Действия (передаются через action с аргументами args): - list: аргументы { page?, limit? (≤100), category?, status?, search? }. Только для чтения. - get: аргументы { id }. Только для чтения. - create: аргументы { name, model, category, description? }. category — одно из: battery, textile, electronics, construction, steel, detergents, paints-coatings, packaging, furniture, tyres, jewelry, toys, fmcg. - update: аргументы { id, name?, model?, description? }; необходимо передать хотя бы одно поле для изменения. - create_batch: аргументы { products: [ { name, model, category, description? }, … ] }, до 100. Частичный успех: ответ содержит статус по каждому элементу, так что одни элементы могут быть созданы, а другие — с ошибкой. Весь пакет потребляет N записей заранее; если это превышает дневной лимит, НЕ создается ничего (429). - archive: аргументы { id }. Мягко архивирует продукт. Блокируется с кодом 409, пока хотя бы один неархивированный паспорт ссылается на него — сначала заархивируйте эти паспорта. Это обратимо и НЕ является удалением.

Обнаруживает схему полей регулирования для каждой категории DPP — что должен содержать СООТВЕТСТВУЮЩИЙ паспорт в соответствии с регулирующим регламентом ЕС. Справочные данные только для чтения. Используйте их для консультаций по требованиям перед созданием продуктов/паспортов и для проверки черновика на соответствие правилам. Действия (передаются через action с args): - list — args: {}. Выводит все 13 категорий с количеством полей, количеством обязательных полей и регулирующим регламентом (название + номер + даты вступления в силу/обязательного применения). - get — args: { category }. Полная схема полей для одной категории: ключ каждого поля, метка, тип данных, является ли оно ОБЯЗАТЕЛЬНЫМ, уровень доступа (public/restricted/authority), варианты enum, границы проверки и, где известно, статья/приложение регламента, которое его предписывает. category принимает одно из значений: battery, textile, electronics, construction, steel, detergents, paints-coatings, packaging, furniture, tyres, jewelry, toys, fmcg. BATTERY — обязательность зависит от категории, поэтому одного поля required недостаточно. Определяйте в таком порядке: 1. СНАЧАЛА ОПРЕДЕЛИТЕ ОБЛАСТЬ ПРИМЕНЕНИЯ. Только аккумуляторы EV, LMT и промышленные более 2 кВтч обязаны иметь паспорт (Статья 77(1), Reg (EU) 2023/1542). Для портативных, SLI или промышленных <=2 кВтч НИ ОДНО поле не является обязательным — не перечисляйте обязательные поля для них; сообщите, что аккумулятор не входит в область применения. 2. Затем используйте requiredBy[batteryCategory], где поле содержит эту карту (required | conditional | notApplicable). 3. Если ничего не подошло, используйте required. Карта индексируется ТОЛЬКО по трём категориям, входящим в область применения, поэтому пропуск шага 1 приводит к использованию required и создаёт обязательство, которое Регламент не налагает. Также обратите внимание, что EV и LMT сообщают о состоянии здоровья через ВЗАИМОИСКЛЮЧАЮЩИЕ наборы полей — аккумулятор EV должен оставлять пустым кластер remaining-capacity, а аккумулятор LMT должен оставлять пустым stateOfCertifiedEnergy, поэтому ни один аккумулятор никогда не заполняет все поля.