REST · JSON · Bearer token · Песочница
API корпоративного мерча
REST API для корпоративных клиентов, имеющих собственную систему закупок, ERP или платформу закупок и нуждающихся в интеграции операции мерча с расчётом, заказом, статусом в реальном времени, доказательствами качества, номером отслеживания и выгрузкой CFDI 4.0 без переписки по электронной почте.
Для чего нужен API
API решает шесть точек контакта между системой закупок клиента и операцией мастерской: расчёт с построчной разбивкой, MOQ, сроком, методом печати и ценой единицы в MXN до НДС; заказ с подтверждением брифа, размерами по SKU и адресом доставки; статус в реальном времени по этапам мастерской (приём, валидация оригинал-макета, производство, контроль качества, упаковка, доставка); доказательства качества с фотографией реза и подписанным актом, когда применяется AQL-выборка; номер отслеживания логистического оператора; CFDI 4.0 с выгрузкой в XML и PDF при выставлении.
API — это не маркетинговый слой и не корзина покупок. Это инструмент технической интеграции для клиентов со структурированной операцией. Если вы работаете с бумажными заказами на закупку и ответственным, который отправляет письма, API вам не подходит — и это нормально, не всем клиентам он нужен.
Архитектура и аутентификация
API предоставляет REST-эндпоинты с JSON-полезной нагрузкой. Аутентификация выполняется через Bearer-токен, передаваемый техническому ответственному клиента после подписания взаимного соглашения о неразглашении. Каждый токен привязан к аккаунту клиента и набору областей: расчёт, заказ, статус, доказательства, выставление счетов. Эндпоинты документированы по OpenAPI 3.1, песочница воспроизводит поведение продуктивной среды на синтетических данных.
Лимит запросов — 60 в минуту на токен, скользящее окно. Когда система закупок клиента требует большего объёма, это оценивается индивидуально, и лимит корректируется с предварительным уведомлением. Вебхуки отправляются из мастерской в систему клиента по ключевым событиям: расчёт утверждён, производство запущено, контроль качества пройден, заказ отправлен, CFDI выставлен. URL вебхука настраивается в панели клиента.
Основные эндпоинты
Контракт API публикуется как техническая ссылка после подписания NDA. Основные эндпоинты: POST /v1/quotes для создания расчёта по структурированному брифу; GET /v1/quotes/{id} для получения расчёта с разбивкой; POST /v1/orders для подтверждения заказа по утверждённому расчёту; GET /v1/orders/{id} для проверки статуса заказа в любой момент; GET /v1/orders/{id}/timeline для восстановления истории с временными метками по этапам; GET /v1/orders/{id}/evidence для выгрузки фотографий контроля качества и, при необходимости, подписанного акта AQL; GET /v1/orders/{id}/cfdi для выгрузки CFDI 4.0 в XML и PDF; GET /v1/shipments/{tracking} для запроса трек-номера перевозчика.
Песочница предоставляет те же эндпоинты с синтетическими данными уже сданных клиентов, продуктов и заказов. Клиенты с собственной командой разработки могут тестировать интеграцию, не затрагивая свою реальную операцию.
Совместимость с распространёнными системами
Мы интегрировали API с клиентами, использующими SAP Ariba, Coupa, Oracle Procurement Cloud и латиноамериканские платформы закупок. Интеграция обычно идёт со стороны клиента: система закупок вызывает API Corp-Merch.MX для создания расчёта, получает структурированный ответ и запускает внутренний поток утверждения до подтверждения заказа. Счёт-фактура CFDI 4.0 выгружается из соответствующего эндпоинта и сверяется с PO в ERP.
Для клиентов без глубокой интеграции мы предлагаем веб-панель с той же информацией, которую отдаёт API: расчёт, заказ, статус, доказательства, номер отслеживания и выгрузка CFDI. Панель — это человеческая версия API и поставляется бесплатно как часть сервиса.
Безопасность и комплаенс
Продуктивные эндпоинты работают по HTTPS с TLS 1.3. Bearer-токены ротируются каждые 90 дней или при смене технического ответственного клиента. Вебхуки подписываются HMAC-SHA256, чтобы система клиента могла проверить, что вызов пришёл от Corp-Merch.MX. Персональные данные, обрабатываемые API, — это данные, необходимые для выставления счёта и доставки: имя, email, RFC, когда применимо, адрес, — и обрабатываются согласно Федеральному закону о защите персональных данных, находящихся во владении частных лиц.
Журнал доступа хранится двенадцать месяцев для целей аудита. Когда клиенту требуются доказательства для собственного внутреннего аудита или для визита PROFECO или SAT, мы предоставляем журнал доступа за соответствующий период с авторизации ответственного клиента.
Случаи, когда API не подходит
Есть три случая, когда API — не тот инструмент. Клиент с одним заказом в год: стоимость технической интеграции превышает выгоду автоматизации; достаточно веб-панели. Клиент без структурированной системы закупок: когда заказ поднимается по почте и утверждается собственноручной подписью, API добавляет трения без упрощения. Разведочный бриф: когда клиент ещё не знает точно, что заказывать, бриф с коммерческим ответственным остаётся правильным путём. API применяется, когда у клиента уже есть повторяющийся поток с Corp-Merch.MX и он хочет автоматизировать.
Запросите доступ к песочнице
Если у вас есть собственная техническая команда и вы хотите оценить интеграцию, мы предоставляем токен песочницы, документацию OpenAPI 3.1 и типичный тестовый кейс. Переход в продуктив происходит после подписания взаимного NDA.
API Corp-Merch.MX — технический инструмент для корпоративных клиентов со структурированной системой закупок. Это не сервис продаж конечному потребителю и не корзина покупок. Эндпоинты, области и лимиты запросов документируются клиенту после подписания NDA. Corp-Merch.MX работает независимо, и информация об API отражает возможности на момент публикации.