{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"e5baeb02-7809-432c-bbed-66b8b2504325","name":"Melonn sellers API","description":"This documentation exposes a collection of APIs that can be used by sellers to integrate with the services offered by Melonn.\n\n> 🚧 This documentation is under construction, if you need to find more information you can check it out at [learn with Melonn](https://melonn.notion.site/Integraciones-c61249d272b6450b82422476854b96b7) \n  \n\n# ✨ Overview\n\nThis is your complete guide to integrating with Melonn’s fulfillment platform.  \nYou will find:\n\n- A detailed description of the **available functionalities**, related with order creation, products, inventory, shipping tracking and some others.\n    \n- An overview of the **business flows** supported by the API.\n    \n- The full list of **webhooks and endpoints with request/response examples**, designed to help you get started quickly.  \n    Our goal is to provide you with everything you need to build a smooth, secure, and scalable integration between your systems and Melonn.\n    \n\n> 🚧 We currently cover topics related to Sales Orders, Buyer Return Orders and Products (PIM) in this documentation, but we'll be adding more information about the actions you can perform with our API soon. \n  \n\n# 🔐 Authentication\n\nYou must provide a token in each request that you must generate in [Orbita](https://admin.melonn.com) platform going to Integrations -> [API](https://admin.melonn.com/api-token) and this must be sent in the headers of each request as `x-api-key`\n\n> _‼️ All endpoints have a request limit of_ _**1 request per second**_. _If you reach this limit then you will receive an status code:_ _**429**_ _and the request will be rejected._ \n  \n\n# 🧪 Environments\n\nBefore you start testing your integration with our API, you can use the sandbox environment provided by Melonn to experiment and test all the API functionalities without affecting real data from your business. Once you have tested that everything works fine, you just need to switch to the production environment.\n\n1. Keep `https://api.orbita.melonn.com` if you are using a production.\n    \n2. Use `https://api.orbita-qa.melonn.com` for sandboxes or test your API integrations.\n    \n\nThe API domain should be used in the `{{api_url}}` variable.\n\n# 📚 Concepts and Definitions\n\n📌 **Bundle**: Grouping multiple items into a single SKU. This allows you to set up your sales channel selling a single SKU but have your inventory unconsolidated in Melonn. It does not imply that Melonn has to consolidate these items in any particular way during packaging.\n\n📌 **CEDIS**: Melonn distribution centers, warehouses or storage facilities.\n\n📌 **Shipping Method**: Used to deliver an order from the warehouse to the final destination. Each shipping method determines the carrier, delivery time frame, and logistics conditions (e.g., same-day delivery, standard delivery, pickup, or express service).\n\n📌 **Destination**: These are your own stores, retailers or distributors to whom you will send the merchandise for B2B orders. Each of these may have one or more delivery points.\n\n📌 **D2C Orders**: D2C orders are those that are usually placed by an individual customer and usually have a low quantity of items.\n\n📌 **KIT**: It is a bundle that also includes some additional packaging preparation (placing items in a box or bag, closing with a sticker, heat shrinking).\n\n📌 **VAS - Value added services**: Additional services to the traditional fulfillment concepts of storage, preparation and transportation.\n\n# 📋 List of entities\n\n## Warehouses\n\n| CEDI | Country | Code |\n| --- | --- | --- |\n| Ciudad de Mexico #1 | MEX | MEX-1 |\n| Barranquilla #1 - Granadillo | COL | BAQ-1 |\n| Bogotá #2 - Montevideo | COL | BOG-2 |\n| Cali #2 - Cámbulos | COL | CAL-2 |\n| Guadalajara #1 | MEX | GDL-1 |\n| Medellin #2 - Sabaneta Mayorca | COL | MED-2 |\n| Medellin #3 - Itagüi | COL | MED-3 |\n| SAS #1 - FP MED | COL | SAS-1 |\n| SAS #2 - Armatura | COL | SAS-2 |\n| Tultitlan #1 | MEX | TLT-1 |\n\n## Shipping methods\n\n| Name | Code |\n| --- | --- |\n| Mismo día hábil local COL | FP-4 |\n| Siguiente día hábil local | FP-5 |\n| Siguiente día hábil - 7am - 1pm | FP-8 |\n| Siguiente día hábil - 1pm - 9pm | FP-9 |\n| Recogida | MEL-13 |\n| Estándar (Local y Nacional) | MEL-15 |\n| Estándar Dermanat | MEL-16 |\n| Envío Premium | MEL-17 |\n| Externo | EXT |\n| Recogida Express | RAPPI |\n| Mismo día hábil local MX | MEL-23 |\n| Siguiente día hábil local mediano | FP-36 |\n| FBA | EXT-FBA |\n| MELI FULL | EXT-MELI |\n| Envío dedicado | SCHEDULED |\n| Recogida Alternativa | MEL-44 |\n| Recogida B2B | MEL-45 |\n| Recogida B2B Alternativa | MEL-46 |\n| Estándar (Local y Nacional) Alt 1 día | MEL-47 |\n| Estándar (Local y Nacional) Alt 2 días | MEL-48 |\n| Estándar B2B (Local y Nacional) | MEL-49 |\n| Estándar B2B (Local y Nacional) Alternativa | MEL-50 |\n| Estándar B2B (Local y Nacional) \\* | MEL-51 |\n| Estándar B2B (Local y Nacional) Alternativa \\* | MEL-52 |\n| Recogida B2B \\* | MEL-53 |\n| Recogida B2B Alternativa \\* | MEL-54 |\n| Externo + 1 Día Hábil | EXT-1D |\n| Externo + 2 Días Hábiles | EXT-2D |\n| Externo 1h | EXT-1H |\n| Externo 2h | EXT-2H |\n| Externo 3h | EXT-3H |\n| Externo 4h | EXT-4H |\n| Externo 5h | EXT-5H |\n| Externo 6h | EXT-6H |\n| Externo 7h | EXT-7H |\n| Externo 8h | EXT-8H |\n| Externo 9h | EXT-9H |\n| Externo 10h | EXT-10H |\n| Externo 11h | EXT-11H |\n| Externo 12h | EXT-12H |\n| Recogida B2B Express | MEL-55 |\n| Externo 13h | EXT-13H |\n| Externo 14h | EXT-14H |\n| Externo 15h | EXT-15H |\n| Externo + 3 Días Hábiles | EXT-3D |\n| Externo + 4 Días Hábiles | EXT-4D |\n| Externo + 5 Días Hábiles | EXT-5D |\n| B2B Cargo | B2B-CARGO |\n| Estándar Low cost | MEL-83 |\n| Estándar Low cost Alt | MEL-84 |\n\n## VAS - Value added services\n\n| Name | Code |\n| --- | --- |\n| Gestión de orden de ingreso | 1 |\n| Etiquetado de ítems - códigos de barras/QR | 2 |\n| Evidencia fotográfica del empacado | 3 |\n| Termosellado de ítems | 4 |\n| Armado de kits | 5 |\n| Detalle del contenido de cada paquete | 6 |\n| Evidencia fotográfica de los paquetes finales | 7 |\n| Incluir dimensiones y peso de paquetes | 8 |\n| Detallar la cantidad de paquetes | 9 |\n| Etiquetado de cada paquete | 10 |\n| Agendamiento de cita para envío | 11 |\n| Impresión de documentos para el envío | 12 |\n| Embalaje de ítems frágiles | 13 |\n| Empaque dirigido | 14 |\n| Limpieza de etiquetas/stickers | 15 |\n| Revisión control de calidad | 16 |\n| Impresión de documentos (Con información operacional) | 17 |\n| Detalle del contenido de cada paquete e impresión. | 18 |\n| Retiro Material de empaque | 19 |\n| Etiquetado de ítems - códigos de barras/QR enviados al CEDI | 20 |\n\nMore details about VAS [here](https://melonn.notion.site/Servicios-de-Valor-Agregado-VAS-para-las-rdenes-B2B-41b69c7e61b24d2687161748b66b1e3b)\n\n## Official destinations\n\n| Name | Code |\n| --- | --- |\n| MELI FULL | MEL-MELI-FULL |\n| Amazon FBA | MEL-AMAZON-FBA |\n| Melonn MX | MEL-MELONN-MX |\n| Melonn COL | MEL-MELONN-COL |\n| MELI FULL COL | MEL-MELI-FULL-COL |\n\n# Sell Order States\n\n| Code | Name | Description |\n| --- | --- | --- |\n| 1 | Received - valid |  |\n| 2 | All items reserved - ready for fulfillment |  |\n| 3 | Picking |  |\n| 4 | Picked |  |\n| 5 | Packed |  |\n| 6 | Picked-up by buyer |  |\n| 7 | Shipped - in transit |  |\n| 8 | Delivered to buyer |  |\n| 9 | Received - invalid fixable |  |\n| 10 | Fixed & valid - to be processed |  |\n| 11 | Error - not able to process |  |\n| 12 | Processing Requested |  |\n| 13 | on stand by - not able to fulfil - no stock |  |\n| 15 | Canceled |  |\n| 17 | On Cancelation Process - to be unpacked & relocated |  |\n| 18 | On Cancelation Process - to be received from courier |  |\n| 19 | In transit - Cancelation requested |  |\n| 20 | Delivery not posible |  |\n| 21 | on stand by - not able to fulfil - expired promises |  |\n| 22 | Packing |  |\n| 23 | Packed - on hold |  |\n| 24 | Prepared for dispatch |  |\n| 25 | Selected for dispatch preparation |  |\n| 26 | All items reserved - fulfillment on hold |  |\n| 27 | Pre Packing - Vas Pending |  |\n| 28 | Ready For Packing |  |\n| 29 | All items reserved - fulfillment on hold - ext. conditionals |  |\n| 30 | All items reserved - fulfillment on hold - int. conditionals |  |\n| 31 | on stand by - not able to fulfil - SM restriction |  |\n\n## Sell Order Promise Info\n\n| Field | Type | Description |\n| --- | --- | --- |\n| promise_source | String (enum)  <br>MELONN/EXTERNAL | Source of the promise information |\n| external_promise_info | Object (JSON) | External promise information from third-party systems |\n| pack_ready_to_sort_promise_min | String (ISO 8601) | Minimum promise date for pack ready to sort |\n| pack_ready_to_sort_promise_max | String (ISO 8601) | Maximum promise date for pack ready to sort |\n| pack_ready_to_sort_promise_processing_date | String (ISO 8601) | Processing date for pack ready to sort promise |\n| pack_ready_to_sort_timestamp | String (ISO 8601) | Actual timestamp when pack was ready to sort |\n| unpack_promise_min | String (ISO 8601) | Minimum promise date for unpacking |\n| unpack_promise_max | String (ISO 8601) | Maximum promise date for unpacking |\n| unpack_promise_processing_date | String (ISO 8601) | Processing date for unpack promise |\n| unpack_timestamp | String (ISO 8601) | Actual timestamp when unpacked |\n| unpack_cancelation_promise_min | String (ISO 8601) | Minimum promise date for unpack cancellation |\n| unpack_cancelation_promise_max | String (ISO 8601) | Maximum promise date for unpack cancellation |\n| unpack_cancelation_promise_processing_date | String (ISO 8601) | Processing date for unpack cancellation promise |\n| unpack_cancelation_timestamp | String (ISO 8601) | Actual timestamp when unpack was cancelled |\n\n## Sell Order Attempt\n\n| Field | Type | Description |\n| --- | --- | --- |\n| current | Boolean | Indicates if this is the current attempt |\n| ready_to_ship_promise_min | String (ISO 8601) | Minimum promise date for ready to ship |\n| ready_to_ship_promise_max | String (ISO 8601) | Maximum promise date for ready to ship |\n| ready_to_ship_promise_processing_date | String (ISO 8601) | Processing date for ready to ship promise |\n| ready_to_ship_timestamp | String (ISO 8601) | Actual timestamp when ready to ship |\n| ship_promise_min | String (ISO 8601) | Minimum promise date for shipping |\n| ship_promise_max | String (ISO 8601) | Maximum promise date for shipping |\n| ship_promise_processing_date | String (ISO 8601) | Processing date for ship promise |\n| ship_timestamp | String (ISO 8601) | Actual timestamp when shipped |\n| delivery_promise_min | String (ISO 8601) | Minimum promise date for delivery |\n| delivery_promise_max | String (ISO 8601) | Maximum promise date for delivery |\n| delivery_promise_processing_date | String (ISO 8601) | Processing date for delivery promise |\n| delivery_timestamp | String (ISO 8601) | Actual timestamp when delivered |\n| ready_to_pickup_promise_min | String (ISO 8601) | Minimum promise date for ready to pickup |\n| ready_to_pickup_promise_max | String (ISO 8601) | Maximum promise date for ready to pickup |\n| ready_to_pickup_processing_date | String (ISO 8601) | Processing date for ready to pickup promise |\n| ready_to_pickup_timestamp | String (ISO 8601) | Actual timestamp when ready to pickup |\n| pickup_promise_min | String (ISO 8601) | Minimum promise date for pickup |\n| pickup_promise_max | String (ISO 8601) | Maximum promise date for pickup |\n| pickup_promise_processing_date | String (ISO 8601) | Processing date for pickup promise |\n| pickup_timestamp | String (ISO 8601) | Actual timestamp when picked up |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"43252198","team":6888644,"collectionId":"e5baeb02-7809-432c-bbed-66b8b2504325","publishedId":"2sAYkEqzk3","public":true,"publicUrl":"https://documenter-api.postman.tech/view/43252198/2sAYkEqzk3","privateUrl":"https://go.postman.co/documentation/43252198-e5baeb02-7809-432c-bbed-66b8b2504325","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2025-03-19T14:57:56.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/e8f60c46e4f07c98deec43b76c7e5da833d637e555ed2ea0547d6671f8511b09","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sAYkEqzk3"}