# info.summary
Order, inventory, and delivery API for e-commerce integrations with MTP Group fulfillment warehouse.

# info.description
REST API for integrating online stores with MTP Group (fulfillmentmtp.com.ua) fulfillment services. Supports order creation, inventory reporting, delivery management, and Nova Poshta / Ukrposhta carrier integration. All requests use HTTPS + UTF-8, JSON request/response bodies, authentication via `ApiKey` field obtained from MTP manager or via `GetToken` method.

# tags[].description
Customer order lifecycle (create, edit, cancel, status)

# tags[].description
Warehouse stock levels and movement reports

# tags[].description
Nova Poshta reference data (cities, warehouses, streets)

# components.securitySchemes.ApiKeyBody.description
MTP-issued ApiKey. Note: the API expects the key as a JSON body field `ApiKey`, not as an HTTP header. Obtain via the `GetToken` method or from your MTP account manager.

# components.schemas.ApiKey.description
UUID-format API key issued by MTP Group.

# components.schemas.StandardResponse.properties.Data.description
Method-specific response payload (object or array).

# components.schemas.StandardResponse.properties.errors.description
List of error descriptions when result='error'.

# components.schemas.DeliveryAddress.description
Delivery address — fields depend on delivery_method.

# components.schemas.DeliveryAddress.properties.WarehouseRef.description
Nova Poshta warehouse UUID (for warehouse delivery)

# components.schemas.DeliveryAddress.properties.DeliveryCity.description
Nova Poshta city UUID (for address delivery)

# components.schemas.Order.properties.key_order.description
MTP internal key (used instead of id_order in EditOrder)

# components.schemas.Order.properties.Draft.description
If true, order is reserved but not shipped

# components.schemas.Order.properties.order_payment_sum.description
COD amount; empty or '0' defaults to order total

# components.schemas.Order.properties.delivery_method.enum[]
Курьерская доставка Киев

# components.schemas.Order.properties.delivery_sender_id.description
Nova Poshta sender ID — coordinate with MTP manager

# paths./GetToken.post.description
Exchange login/password credentials for an ApiKey used in all subsequent calls.

# paths./getCities.post.description
Returns Nova Poshta city reference matching the given partial name.

# paths./getWarehouses.get.summary
Get full Nova Poshta warehouse list (GET form)

# paths./AddProduct.post.summary
Create or update a product in MTP catalog

# paths./AddProduct.post.description
Adds a new product or updates an existing one by SKU. Use AnswerOption='Correct' for standard validation.

# paths./AddOrder.post.description
Creates a new customer order with delivery via Nova Poshta, Ukrposhta, own courier, or pickup. Supports warehouse, address, and own-TTN delivery modes.

# paths./EditOrder.post.description
Same request shape as AddOrder but uses `key_order` instead of `id_order` to identify the order.

# paths./ReportStatusOrder.post.description
Returns MTP status, Nova Poshta TTN, and full tracking history for each order ID in the list.

# paths./getStatusOrder.get.summary
Get dictionary of all MTP order statuses

# paths./ListOrder.post.summary
List orders within a date range (paginated)

# paths./ListOrder.post.description
Returns up to 100 orders per page. Use `page` to iterate.

# paths./ListReturnOrder.post.summary
List customer returns within a date range (paginated)

# paths./ListReturnOrder.post.description
Returns up to 100 return receipts per page with line-item details including marriage (defective) flag.

# paths./ReportSklad.post.description
Returns current stock: `quantity` (on hand), `quantityAvailable` (available for sale), `stock` (accounting stock).

# paths./ReportMoveProduct.post.summary
Product movement report by SKU and date range

# paths./ReportMoveProduct.post.description
Returns inbound/outbound movements, running balance, and source documents (movements, returns, decomposition, etc.).

# paths./senderDetails.post.summary
List available Nova Poshta senders (your own legal entities)

# paths./ListDeliveryRequest.post.summary
List inbound delivery requests (supply to warehouse)

# paths./ListDeliveryRequest.post.description
⚠ Uses base URL `/MTPGroupFulfillment/hs/api2v/json` (v2 endpoint). `method` field in body specifies operation.

# paths./AddDeliveryRequest.post.description
⚠ Uses base URL `/MTPGroupFulfillment/hs/api2v/json` (v2 endpoint).

# paths./ReportDeliveryRequest.post.summary
Get status of an inbound delivery request

# paths./ReportDeliveryRequest.post.description
⚠ Uses base URL `/MTPGroupFulfillment/hs/api2v/json`. Status values: 1=new, 2=arrived but not fully received, 3=receiving completed and confirmed.

# paths./ReportDeliveryRequest.post.requestBody.content.application/json.schema.properties.properties.properties.id.description
Delivery request ID from AddDeliveryRequest