openapi: 3.0.0 info: title: VTex Anti-fraud Provider Account External Marketplace API description: ">ℹ️ Onboarding guide\r\n>\r\n> Check the new [Payments onboarding guide](https://developers.vtex.com/docs/guides/payments-overview). We created this guide to improve the onboarding experience for developers at VTEX. It assembles all documentation on our Developer Portal about Payments and is organized by focusing on the developer's journey.\r\n\r\nThe Anti-fraud Provider Protocol is a set of definitions to help you integrate your anti-fraud service API into VTEX platform.\r\n\r\nTo achieve this, you need to implement a web API (REST) following the specifications described in this documentation.\r\n\r\n>⚠️ You can also access our [template on GitHub](https://github.com/vtex-apps/antifraud-provider-example) to help you quickly develop your anti-fraud connector using the Anti-fraud Provider Protocol and VTEX IO.\r\n\r\nTo learn more about the Anti-fraud Provider Protocol, check our [developer guide](https://developers.vtex.com/docs/guides/how-the-integration-protocol-between-vtex-and-antifraud-companies-works).\r\n\r\n## Anti-fraud Provider API Index\r\n\r\n### Anti-fraud Flow\r\n\r\n- `POST` [Send Anti-fraud Pre-Analysis Data (optional)](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#post-/pre-analysis)\r\n- `POST` [Send Anti-fraud Data](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#post-/transactions)\r\n- `PUT` [Update Anti-fraud Transactions (optional)](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#put-/transactions/-transactionId-)\r\n- `GET` [List Anti-fraud Provider Manifest](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#get-/manifest)\r\n- `GET` [Get Anti-fraud Status](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#get-/transactions/-transactions.id-)\r\n- `DELETE` [Stop Anti-fraud Analysis (optional)](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#delete-/transactions/-transactions.Id-)\r\n\r\n### OAuth Flow\r\n\r\n1. `POST` [Retrieve Token](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#post-/authorization/token)\r\n2. `GET` [Redirect](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#get-/redirect)\r\n3. `GET` [Return to VTEX](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#get-/authorizationCode)\r\n4. `GET` [Get Credentials](https://developers.vtex.com/docs/api-reference/antifraud-provider-protocol#get-/authorization/credentials)" version: '1.0' servers: - url: https://{providerApiEndpoint} description: Anti-fraud provider endpoint URL. variables: providerApiEndpoint: description: Anti-fraud provider endpoint URL. default: '{providerApiEndpoint}' tags: - name: External Marketplace paths: /api/channel-manager/channel/all: get: tags: - External Marketplace summary: VTex List all channels description: This request returns a list of channels available channels with their respective IDs for partners external to VTEX. operationId: list-all-channels parameters: - name: enviroment in: path description: Environment used as part of the URL. required: true style: simple schema: type: string example: portal.vtexcommercestable.com.br - name: an in: query description: VTEX's account name owned by the connector/partner. required: true style: form schema: type: string example: accountName - name: Accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: Content-type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json responses: '200': description: OK headers: {} content: application/json: schema: title: Response body description: Expected response body from List all channels. type: object required: - id - name properties: id: title: 'Id ' description: The channel id. type: integer example: 1 name: title: Name description: The channel name. type: string example: Mercado Livre example: id: 1 name: Mercado Livre deprecated: false /api/channel-manager/channel/:channelId: get: tags: - External Marketplace summary: VTex Retrieve channel description: Retrieves a specific channel that already exists in Channel Manager. operationId: retrieve-channel parameters: - name: enviroment in: path description: Environment used as part of the URL. required: true style: simple schema: type: string example: portal.vtexcommercestable.com.br - name: an in: query description: VTEX's account name owned by the connector/partner. required: true style: form schema: type: string example: accountName - name: channelId in: path description: Channel's ID in Channel Manager, available through the List All Channels endpoint. required: true style: simple schema: type: number example: 1 - name: Accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: Content-type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json responses: '200': description: OK headers: {} content: application/json: schema: type: object title: '' description: Expected response body from List all channels. required: - id - name properties: id: title: 'Id ' description: The channel id. type: integer example: 1 name: title: Name description: The channel name. type: string example: Mercado Livre example: id: 1 name: Mercado Livre /api/mkp-category-mapper/connector/register: post: tags: - External Marketplace summary: VTEX Mapper Registration description: "Mappes categories guarantees that the VTEX category tree has a correct association with the marketplace’s category tree. \n\nTo perform this association, VTEX made VTEX Mapper available. It is a tool integrated into the VTEX platform that allows the user to relate categories created in VTEX to categories from the marketplace. \n\nThis endpoint allows connectors to register the external marketplace integration in VTEX Mapper. \n\nIn case VTEX Mapper detects an error and the call fails, the connector should check if mandatory information was sent correctly. Ex. Are URLs correctly registered in the properties `categoryTreeEndPoint` and `mappingEndPoint`? \n\nFor a detailed explanation of the steps required to develop a custom connector to become an external marketplace for VTEX sellers, check out our complete [External Marketplace Integration Guide](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-guide)." operationId: vtex-mapper-registration parameters: - name: an in: query description: Name of the VTEX account. Used as part of the URL. required: true style: form schema: type: string example: accountName - name: Content-Type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json - name: Accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json requestBody: description: '' content: application/json: schema: $ref: '#/components/schemas/VtexMapperRegistration' required: true responses: '200': description: OK headers: {} deprecated: false /api/mkp-category-mapper/categories/marketplace/{id}: post: tags: - External Marketplace summary: Send Category Mapping to VTEX Mapper description: "Mappes categories guarantees that the VTEX category tree has a correct association with the marketplace’s category tree. \n\nTo perform this association, VTEX made VTEX Mapper available. It is a tool integrated into the VTEX platform that allows the user to relate categories created in VTEX to categories from the marketplace. \n\nThis endpoint allows connectors to send the marketplace's category tree mapped in the integration. \n\nConnectors should send the payload compacted in `.gzip` format. \n\nFor a detailed explanation of the steps required to develop a custom connector to become an external marketplace for VTEX sellers, check out our complete [External Marketplace Integration Guide](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-guide)." operationId: send-category-mapping-vtex-mapper parameters: - name: Content-Type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json - name: Accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: id in: path description: Code identifying returned in the *VTEX Mapper Registration* endpoint. required: true style: simple schema: type: string default: '123456789' requestBody: description: '' content: application/json: schema: $ref: '#/components/schemas/sendCategoryMappingToVtexMapper' required: true responses: '200': description: OK headers: {} deprecated: false /api/channel-manager/connector: post: tags: - External Marketplace summary: VTex Register connector description: "Registers a new connector in our platform. The account name informed in the request should be the one owned by the partner since it is the only account that will have permission to update or delete the connector.\r\n\r\nPossible values for field `type`:\r\n\r\n- `APP`, if using our App Template.\r\n- `EXTERNAL`, if not using App Template.\r\n\r\nPossible values for field `segment`:\r\n\r\n- `ADS`\r\n- `APPAREL_ACCESSORIES`\r\n- `BEAUTY_HEALTH`\r\n- `BOOKS_EDUCATION`\r\n- `CARS_AUTOPARTS`\r\n- `DEPARTMENT_STORES`\r\n- `ELETRONICS`\r\n- `FINANCIAL_INSURANCES`\r\n- `FOOD_BEVERAGES`\r\n- `GROCERY`\r\n- `HOME_APPLIANCES`\r\n- `HOME_FURNITURE_DECOR`\r\n- `JEWELRY`\r\n- `PET_SHOP`\r\n- `SPORTS_FITNESS`\r\n- `TOURISM`\r\n- `TOYS_HOBBIES`\r\n- `OTHERS`" operationId: register-connector parameters: - name: Accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: Content-Type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json - name: environment in: path description: Environment used as part of URL. required: true style: simple schema: type: string example: https://portal.vtexcommercestable.com.br - name: an in: query description: VTEX's account name owned by the connector/partner, ex. `apiexemple` required: true style: form schema: type: string example: apiexemple requestBody: description: Body of the request to execute the Resgister connector. content: application/json: schema: required: - name - website - logo - description - segment - availableCountries - type - isActive - helpUrl - connectorVtexAdminPath - connectorPageUrl - connectorApiEndpoint - channelId properties: name: type: string title: name example: Mercado Livre Classic website: type: string title: website example: mercadolivre.com.br logo: type: string title: logo example: https://g.foolcdn.com/art/companylogos/square/meli.png description: type: string title: description example: MercadoLibre operates online commerce platforms in Latin America. It operates Mercado Libre Marketplace, an automated online commerce platform that enables businesses, merchants, and individuals to list merchandise and conduct sales and purchases online. segment: type: string title: segment example: OTHERS availableCountries: type: array title: availableCountries items: type: string title: Countries example: BRA example: - BRA - ARG type: type: string title: type example: EXTERNAL isActive: type: boolean title: isActive example: true helpUrl: type: string title: helpUrl example: https://help.vtex.com/pt/tracks/configurar-integracao-do-mercado-livre--2YfvI3Jxe0CGIKoWIGQEIq connectorVtexAdminPath: type: string title: connectorVtexAdminPath example: /bridge/#/settings?openConfig=mercadolivre connectorPageUrl: type: string title: connectorPageUrl example: https://apps.vtex.com/vtexbr-tiktok-tbp/p connectorApiEndpoint: type: string title: connectorApiEndpoint example: portal.vtexcommercestable.com/api/meliintegration/notifications channelId: type: integer title: channelId example: 1 example: - name: Mercado Livre Classic website: mercadolivre.com.br logo: https://g.foolcdn.com/art/companylogos/square/meli.png description: MercadoLibre operates online commerce platforms in Latin America. It operates Mercado Libre Marketplace, an automated online commerce platform that enables businesses, merchants, and individuals to list merchandise and conduct sales and purchases online. segment: OTHERS availableCountries: - BRA - ARG type: EXTERNAL isActive: true helpUrl: https://help.vtex.com/pt/tracks/configurar-integracao-do-mercado-livre--2YfvI3Jxe0CGIKoWIGQEIq connectorVtexAdminPath: /bridge/#/settings?openConfig=mercadolivre connectorPageUrl: https://apps.vtex.com/vtexbr-tiktok-tbp/p connectorApiEndpoint: portal.vtexcommercestable.com/api/meliintegration/notifications channelId: 1 responses: '200': description: OK headers: {} content: application/json: schema: type: object title: Response body required: - id - name - website - logo - description - helpUrl - segment - availableCountries - availableStates - type - connectorPageUrl - connectorVtexAdminPath - connectorApiEndpoint - channelId - isGloballyAvailable - ownerVtexAccount - isActive - isCertified - contactInfo - isConnectionActive - affiliateId properties: id: type: integer title: id example: 584 name: type: string title: name example: Mercado Livre Classic website: type: string title: website example: mercadolivre.com.br logo: type: string title: logo example: https://g.foolcdn.com/art/companylogos/square/meli.png description: type: string title: description example: MercadoLibre operates online commerce platforms in Latin America. It operates Mercado Libre Marketplace, an automated online commerce platform that enables businesses, merchants, and individuals to list merchandise and conduct sales and purchases online. helpUrl: type: string title: helpUrl example: https://help.vtex.com/pt/tracks/configurar-integracao-do-mercado-livre--2YfvI3Jxe0CGIKoWIGQEIq segment: type: string title: segment example: OTHERS availableCountries: type: array title: availableCountries items: type: string title: A Schema example: BRA example: - BRA - ARG availableStates: type: array title: availableStates items: {} example: - [] type: type: string title: type example: EXTERNAL connectorPageUrl: type: string title: connectorPageUrl example: https://apps.vtex.com/vtexbr-tiktok-tbp/p connectorVtexAdminPath: type: string title: connectorVtexAdminPath example: /bridge/#/settings?openConfig=mercadolivre connectorApiEndpoint: type: string title: connectorApiEndpoint example: portal.vtexcommercestable.com/api/meliintegration/notifications channelId: type: integer title: channelId example: 1 isGloballyAvailable: type: boolean title: isGloballyAvailable example: false ownerVtexAccount: type: string title: ownerVtexAccount example: vtex isActive: type: boolean title: isActive example: true isCertified: type: boolean title: isCertified example: false contactInfo: type: object title: contactInfo required: - name - email - phone - defaultMessage properties: name: type: string title: name example: Jhon email: type: string title: email example: jhon@marketplace.com phone: type: string title: phone example: (77) 7777-7777 defaultMessage: type: string title: defaultMessage example: '' example: name: Jhon email: jhon@marketplace.com phone: (77) 7777-7777 defaultMessage: '' isConnectionActive: type: boolean title: isConnectionActive example: false affiliateId: type: string title: affiliateId example: '1234' example: id: 584 name: Mercado Livre Classic website: mercadolivre.com.br logo: https://g.foolcdn.com/art/companylogos/square/meli.png description: MercadoLibre operates online commerce platforms in Latin America. It operates Mercado Libre Marketplace, an automated online commerce platform that enables businesses, merchants, and individuals to list merchandise and conduct sales and purchases online. helpUrl: https://help.vtex.com/pt/tracks/configurar-integracao-do-mercado-livre--2YfvI3Jxe0CGIKoWIGQEIq segment: OTHERS availableCountries: - BRA - ARG availableStates: [] type: EXTERNAL connectorPageUrl: https://apps.vtex.com/vtexbr-tiktok-tbp/p connectorVtexAdminPath: /bridge/#/settings?openConfig=mercadolivre connectorApiEndpoint: portal.vtexcommercestable.com/api/meliintegration/notifications channelId: 1 isGloballyAvailable: false ownerVtexAccount: vtex isActive: true isCertified: false contactInfo: name: Jhon email: jhon@marketplace.com phone: (77) 7777-7777 defaultMessage: '' isConnectionActive: false affiliateId: '1234' deprecated: false /api/channel-manager/connector/all: get: tags: - External Marketplace summary: VTex List all connectors description: Returns a paginated list of all connectors' registered in Channel Manager, taking into consideration the filters informed in the query string of the request. operationId: list-all-connectors parameters: - name: environment in: path description: Environment used as part of URL. required: true style: simple schema: type: string example: https://portal.vtexcommercestable.com.br - name: an in: query description: Merchant's account name in VTEX, ex. `apiexemple`. required: true style: form schema: type: string example: apiexemple - name: segment in: query description: Filter data by connector's segment. required: false style: form schema: type: string example: department_stores - name: orderByConnectorType in: query description: Order data using a custom logic by connector's' type, and not alphabetically. required: false style: form schema: type: string example: 'true' - name: active in: query description: Filter data by the connector's status. required: false style: form schema: type: string example: 'true' - name: name in: query description: Filter data by the connector's name. required: false style: form schema: type: string example: Dafiti - name: page in: query description: Current page to load data from. required: false style: form schema: type: integer example: 1 - name: pageSize in: query description: Page size to define number of results returned. required: true style: form schema: type: integer example: 15 - name: country in: query description: Filter by connector's country. required: false style: form schema: type: string example: bra - name: type in: query description: Filter by connector's type. required: false style: form schema: type: string example: vtex - name: account in: query description: Filter by connector's owner account. required: false style: form schema: type: string example: cea - name: accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: content-type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json responses: '200': description: OK headers: {} content: application/json: schema: title: Response body description: Expected success response from List all connector API. type: object required: - metadata - results properties: metadata: title: metadata description: Summary of data returned by the query. type: object required: - totalCount - currentPage - pageSize - totalPages properties: totalCount: title: totalCount description: Total data returned. type: number example: 493 currentPage: title: currentPage description: Current result page. type: number example: 1 pageSize: title: pageSize description: How many results will be displayed per page. type: number example: 5 totalPages: title: totalPages description: Total pages the query returned. type: number example: 99 example: totalCount: 493 currentPage: 1 pageSize: 5 totalPages: 99 results: title: results description: Query result with information for each connector. type: array items: title: '' description: '' type: object required: - id - name - website - logo - description - helpUrl - segment - availableCountries - availableStates - type - connectorPageUrl - connectorVtexAdminPath - connectorApiEndpoint - channelId - isGloballyAvailable - ownerVtexAccount - isActive - isCertified - contactInfo - isConnectionActive - affiliateId properties: id: title: id description: Connector Id. type: number example: 59 name: title: name description: Connecto's name. type: string example: 4R Comercial Sao Paulo website: title: website description: Connector's Website. type: string example: www.comercialsaopaulo.com logo: title: logo description: Logo used by the connector. type: string example: https://comercialsaopaulo.vtexassets.com/assets/vtex.file-manager-graphql/logo/619f6f7f-bf67-4ed1-a15a-282b51f81e06___cd0426736f2550559c8688de3378681f.jpg description: title: description description: Connector presentation. type: string example: 'Somo uma empresa sedeada em Barreiras - BA, decidimos entrar no mundo do E Commerce e marketplace há alguns anos, pois já estávamos estabelecidos e sólidos com a nossa loja física em nossa cidade. Hoje trabalhamos com um portfólio bem diversificado de produtos, que são eles: - Linha à bateria - Lazer e esporte - Camping - Ferramentas elétricas - Maquinários leves e pesados - Ferramentas manuais - E muitos outros segmentos Sua ' helpUrl: title: helpUrl description: URL to connector integration page. type: string example: help.vtex.com segment: title: segment description: Market segment. type: string example: DEPARTMENT_STORES availableCountries: title: availableCountries description: Countries in which connector is available for integration. type: array items: title: availableCountries description: '' type: string example: BRA example: - BRA availableStates: title: availableStates description: Connector actuation states, valid only for connectors that have range restriction. type: array items: {} example: - [] type: title: type description: What type of connector, if it is native, VTEX or partner. type: string example: VTEX connectorPageUrl: title: connectorPageUrl description: URL where the merchant will be redirected to start the onboarding process. type: string example: https://connector.com/connector connectorVtexAdminPath: title: connectorVtexAdminPath description: Admin VTEX URL, where the merchant will be redirected to manage and view his connections after integration. type: string example: https://connector.com/connector connectorApiEndpoint: title: connectorApiEndpoint description: Partner Connector API base URL. type: string example: https://connector.com/connector channelId: title: channelId description: ID of the channel that a connector joins to. type: string example: '1234' isGloballyAvailable: title: isGloballyAvailable description: In which version the connector is available. type: boolean example: false ownerVtexAccount: title: ownerVtexAccount description: Connector account name in VTEX. type: string example: comercialsaopaulo isActive: title: isActive description: Demonstrates the status of integration with the connector. type: boolean example: false isCertified: title: isCertified description: Demonstrates Demonstrates if the connector is certified. type: boolean example: true contactInfo: title: contactInfo description: Seller contact information. type: object required: - name - email - phone - defaultMessage properties: name: title: name description: Name of the person responsible for the marketplace account interested in connecting to the merchant. type: string example: Jhon Jones email: title: email description: Email of the person responsible for the marketplace account interested in connecting to the merchant. type: string example: comersialsp@comercialsaopaulo.com phone: title: phone description: Phone of the person responsible for the marketplace account interested in connecting to the merchant. type: string example: (77) 7777-7777 defaultMessage: title: defaultMessage description: Introduction message and information of interest in the partnership with the merchant. type: string example: "Olá, aqui é (...) da (...). Adoraríamos incluir sua loja em nossa vitrine, pois acreditamos que (...). Seguem algumas informações importantes para darmos seguimento à nossa parceria:\n\n1) Nosso marketplace conta com as categorias\n- A\n- B\n- C\n\n2) Nossa política de cobrança inclui uma taxa de (...) para cada compra, mais assinatura fixa de (...) por mês. \n\n3) Saiba mais sobre nossa política de devoluções e envio neste link (...)." example: name: Jhon Jones email: comercialsp@comercialsaopaulo.com phone: (77) 7777-7777 defaultMessage: "Olá, aqui é (...) da (...). Adoraríamos incluir sua loja em nossa vitrine, pois acreditamos que (...). Seguem algumas informações importantes para darmos seguimento à nossa parceria:\n\n1) Nosso marketplace conta as categorias\n- A\n- B\n- C\n\n2) Nossa política de cobrança inclui uma taxa de (...) para cada compra, mais assinatura fixa de (...) por mês. \n\n3) Saiba mais sobre nossa política de devoluções e envio neste link (...)." isConnectionActive: title: isConnectionActive description: '' type: boolean example: false affiliateId: title: affiliateId description: affiliate Id connector. type: string example: '1234' example: id: 59 name: 4R Comercial Sao Paulo website: www.comercialsaopaulo.com logo: https://comercialsaopaulo.vtexassets.com/assets/vtex.file-manager-graphql/logo/619f6f7f-bf67-4ed1-a15a-282b51f81e06___cd0426736f2550559c8688de3378681f.jpg description: 'Somo uma empresa sedeada em Barreiras - BA, decidimos entrar no mundo do E Commerce e marketplace há alguns anos, pois já estávamos estabelecidos e sólidos com a nossa loja física em nossa cidade. Hoje trabalhamos com um portfólio bem diversificado de produtos, que são eles: - Linha à bateria - Lazer e esporte - Camping - Ferramentas elétricas - Maquinários leves e pesados - Ferramentas manuais - E muitos outros segmentos Sua ' helpUrl: help.vtex.com/helpurl segment: DEPARTMENT_STORES availableCountries: - BRA availableStates: [] type: VTEX connectorPageUrl: conector.com/connectorPageUrl connectorVtexAdminPath: connector.com/connectorVtexAdminPath connectorApiEndpoint: connector.com/connectorApiEndpoint channelId: '1234' isGloballyAvailable: false ownerVtexAccount: comercialsaopaulo isActive: false isCertified: true contactInfo: name: Jhon Jones email: comercialsp@comercialsaopaulo.com phone: (77) 7777-7777 defaultMessage: "Olá, aqui é (...) da (...). Adoraríamos incluir sua loja em nossa vitrine, pois acreditamos que (...). Seguem algumas informações importantes para darmos seguimento à nossa parceria:\n\n1) Nosso marketplace conta as categorias\n- A\n- B\n- C\n\n2) Nossa política de cobrança inclui uma taxa de (...) para cada compra, mais assinatura fixa de (...) por mês. \n\n3) Saiba mais sobre nossa política de devoluções e envio neste link (...)." isConnectionActive: false affiliateId: '1234' example: - id: 59 name: 4R Comercial Sao Paulo website: www.comercialsaopaulo.com logo: https://comercialsaopaulo.vtexassets.com/assets/vtex.file-manager-graphql/logo/619f6f7f-bf67-4ed1-a15a-282b51f81e06___cd0426736f2550559c8688de3378681f.jpg description: 'Somo uma empresa sedeada em Barreiras - BA, decidimos entrar no mundo do E Commerce e marketplace há alguns anos, pois já estávamos estabelecidos e sólidos com a nossa loja física em nossa cidade. Hoje trabalhamos com um portfólio bem diversificado de produtos, que são eles: - Linha à bateria - Lazer e esporte - Camping - Ferramentas elétricas - Maquinários leves e pesados - Ferramentas manuais - E muitos outros segmentos Sua ' helpUrl: help.vtex.com/helpurl segment: DEPARTMENT_STORES availableCountries: - BRA availableStates: [] type: VTEX connectorPageUrl: connector.com/connectorPageUrl connectorVtexAdminPath: connector.com/connectorVtexAdminPath connectorApiEndpoint: connector.com/connectorApiEndpoint channelId: '1234' isGloballyAvailable: false ownerVtexAccount: comercialsaopaulo isActive: false isCertified: true contactInfo: name: Jhon email: contato@comercial.com phone: (77) 7777-7777 defaultMessage: "Olá, aqui é (...) da (...). Adoraríamos incluir sua loja em nossa vitrine, pois acreditamos que (...). Seguem algumas informações importantes para darmos seguimento à nossa parceria:\n\n1) Nosso marketplace conta as categorias\n- A\n- B\n- C\n\n2) Nossa política de cobrança inclui uma taxa de (...) para cada compra, mais assinatura fixa de (...) por mês. \n\n3) Saiba mais sobre nossa política de devoluções e envio neste link (...)." isConnectionActive: false affiliateId: '1234' example: metadata: totalCount: 513 currentPage: 1 pageSize: 15 totalPages: 35 results: - id: 59 name: 4R Comercial Sao Paulo website: www.comercialsaopaulo.com logo: https://comercialsaopaulo.vtexassets.com/assets/vtex.file-manager-graphql/logo/619f6f7f-bf67-4ed1-a15a-282b51f81e06___cd0426736f2550559c8688de3378681f.jpg description: 'Somo uma empresa sedeada em Barreiras - BA, decidimos entrar no mundo do E Commerce e marketplace há alguns anos, pois já estávamos estabelecidos e sólidos com a nossa loja física em nossa cidade. Hoje trabalhamos com um portfólio bem diversificado de produtos, que são eles: - Linha à bateria - Lazer e esporte - Camping - Ferramentas elétricas - Maquinários leves e pesados - Ferramentas manuais - E muitos outros segmentos Sua ' helpUrl: help.vtex.com/helpurl segment: DEPARTMENT_STORES availableCountries: - BRA availableStates: [] type: VTEX connectorPageUrl: connector.vtex.com/connectorPageUrl connectorVtexAdminPath: connector.vtex.com/connectorVtexAdminPath connectorApiEndpoint: connector.vtex.com/connectorApiEndpoint channelId: '1234' isGloballyAvailable: false ownerVtexAccount: comercialsaopaulo isActive: false isCertified: true contactInfo: name: Jhon Jones email: comercialsp@comercialsaopaulo.com phone: (77) 7777-7777 defaultMessage: "Olá, aqui é (...) da (...). Adoraríamos incluir sua loja em nossa vitrine, pois acreditamos que (...). Seguem algumas informações importantes para darmos seguimento à nossa parceria:\n\n1) Nosso marketplace conta as categorias\n- A\n- B\n- C\n\n2) Nossa política de cobrança inclui uma taxa de (...) para cada compra, mais assinatura fixa de (...) por mês. \n\n3) Saiba mais sobre nossa política de devoluções e envio neste link (...)." isConnectionActive: false affiliateId: '1234' deprecated: false /api/channel-manager/connector/:connectorId: get: tags: - External Marketplace summary: VTex Retrieve connector description: Retrieve a specific connector registered in VTEX platform. operationId: retrieve-connector parameters: - name: environment in: path description: Environment used as part of URL. required: true style: simple schema: type: string example: https://portal.vtexcommercestable.com.br - name: connectorId in: path description: Connector's ID in Channel Manager, available through the List all connectors, or in the response of the registration. required: true style: simple schema: type: integer example: 46 - name: an in: query description: VTEX's account name owned by the connector/partner. required: true style: form schema: type: string example: apiexemple - name: accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: content-type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json responses: '200': description: OK headers: {} content: application/json: schema: title: Response body description: Expected response body of Retrieve connector type: object required: - id - name - website - logo - description - helpUrl - segment - availableCountries - availableStates - type - connectorPageUrl - connectorVtexAdminPath - connectorApiEndpoint - channelId - isGloballyAvailable - ownerVtexAccount - isActive - isCertified - contactInfo - isConnectionActive - affiliateId properties: id: title: Id description: The connector Id. type: number example: 46 name: title: Connector name description: Connector name to retrieve. type: string example: B2W website: title: Website description: Website connector. type: string example: https://venda.americanasmarketplace.com.br/cadastre-sua-loja/ logo: title: Logo description: '' type: string example: https://s3.amazonaws.com/Marketplace-Integration/Bridge/logos/skyhub.png description: title: Description description: Description about the connector. type: string example: A B2W e as Lojas Americanas fizeram uma fusão, dando origem ao Americanas Marketplace. Através do conector nativo da VTEX, é possível integrar com a B2W e aumentar seus canais de venda. helpUrl: title: helpUrl description: Link to User Documentation on Connector Setup. type: string example: https://help.vtex.com/pt/tracks/configurar-integracao-da-b2w--6w07SJBVqE020KIOOS8ygk segment: title: segment description: Connector segment. type: string example: DEPARTMENT_STORES availableCountries: title: availableCountries description: Countries where the marketplace is available. type: array items: title: country description: '' type: string example: BRA example: - BRA availableStates: title: availableStates description: '' type: array items: {} example: - [] type: title: type description: Connector integration type. type: string example: NATIVE connectorPageUrl: title: connectorPageUrl description: In the `connectorPageUrl` field, the partner fills in a complete URL where the merchant will be redirected to start the integration process. type: string example: '' connectorVtexAdminPath: title: connectorVtexAdminPath description: It's the URL path inside our admin where the merchant can be redirected to manage and view his connection after it's already integrated. type: string example: /admin/marketplace-network/configuration/skyhub/ connectorApiEndpoint: title: connectorApiEndpoint description: The field refers to the base URL of the partner connector's API. type: string example: https://portal.vtexcommercestable.com.br/api/skyhubintegration channelId: title: channelId description: Channel Id that can be queried through the List all channels. type: number example: 7 isGloballyAvailable: title: isGloballyAvailable description: In which version the connector is available. type: boolean example: false ownerVtexAccount: title: ownerVtexAccount description: ' Owner account VTEX.' type: string example: vtex isActive: title: isActive description: Demonstrates the status of integration with the connector. type: boolean example: true isCertified: title: isCertified description: Demonstrates Demonstrates if the connector is certified. type: boolean example: false contactInfo: title: contactInfo description: Seller contact information. type: object required: - name - email - phone - defaultMessage properties: name: title: name description: Name of the person responsible for the marketplace account interested in connecting to the merchant. type: string example: Jhon email: title: email description: Email of the person responsible for the marketplace account interested in connecting to the merchant. type: string example: jhon@marketplace.com phone: title: phone description: Phone of the person responsible for the marketplace account interested in connecting to the merchant. type: string example: (77) 7777-7777 defaultMessage: title: defaultMessage description: Introduction message and information of interest in the partnership with the merchant. type: string example: "Olá, aqui é (...) da (...). Adoraríamos incluir sua loja em nossa vitrine, pois acreditamos que (...). Seguem algumas informações importantes para darmos seguimento à nossa parceria:\n\n1) Nosso marketplace conta as categorias\n- A\n- B\n- C\n\n2) Nossa política de cobrança inclui uma taxa de (...) para cada compra, mais assinatura fixa de (...) por mês. \n\n3) Saiba mais sobre nossa política de devoluções e envio neste link (...)." example: name: Jhon email: jhon@marketplace.com phone: (77) 7777-7777 defaultMessage: "Olá, aqui é (...) da (...). Adoraríamos incluir sua loja em nossa vitrine, pois acreditamos que (...). Seguem algumas informações importantes para darmos seguimento à nossa parceria:\n\n1) Nosso marketplace conta as categorias\n- A\n- B\n- C\n\n2) Nossa política de cobrança inclui uma taxa de (...) para cada compra, mais assinatura fixa de (...) por mês. \n\n3) Saiba mais sobre nossa política de devoluções e envio neste link (...)." isConnectionActive: title: isConnectionActive description: '' type: boolean example: true affiliateId: title: affiliateId description: affiliate Id connector. type: string example: BTW deprecated: false post: tags: - External Marketplace summary: VTex Upsert merchant connection description: 'Receives an event describing a connection update between the connector with the specified ID and the merchant specified in the query string. /n/r This information is used in the list all connectors route: the account name will be used to return the `isConnectionActive` and `affiliateId` fields.' operationId: upsert-merchant-connection parameters: - name: Accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: Content-Type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json - name: environment in: path description: Environment used as part of URL. required: true style: simple schema: type: string example: https://portal.vtexcommercestable.com.br - name: connectorId in: path description: Connector's ID in Channel Manager, available through the list all connectors route, or in the response of the registration. required: true style: simple schema: type: integer example: 46 - name: an in: query description: Merchant's account name in VTEX, ex. `apiexemple`. required: true style: form schema: type: string example: apiexemple requestBody: description: '' content: application/json: schema: $ref: '#/components/schemas/upsertMerchantConnection' example: isActive: true affiliateId: B2W responses: '200': description: OK headers: {} deprecated: false delete: tags: - External Marketplace summary: VTex Remove connector description: Removes a connector from VTEX platform. This action can only be executed by the account name that owns the connector's registration. operationId: remove-connector parameters: - name: environment in: path description: Environment used as part of URL. required: true style: simple schema: type: string example: https://portal.vtexcommercestable.com.br - name: connectorId in: path description: Connector's ID in Channel Manager, available through the List all connectors route, or in the response of the registration. required: true style: simple schema: type: number example: 46 - name: Accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: Content-Type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json - name: an in: query description: Merchant's account name in VTEX, ex. `apiexemple`. required: true style: form schema: type: string example: apiexemple responses: '200': description: OK headers: {} deprecated: false put: tags: - External Marketplace summary: VTex Full update connector description: Fully updates the connector's information. All required fields must be sent in the body of the request./n/nThis action can only be executed by the account name that owns the connector's registration. operationId: full-update-connector parameters: - name: Accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: environment in: path description: Environment used as part of URL. required: true style: simple schema: type: string example: https://portal.vtexcommercestable.com.br - name: connectorId in: path description: Connector's ID in Channel Manager, available through the list all connectors route, or in the response of the registration. required: true style: simple schema: type: number example: 46 - name: an in: query description: VTEX's account name owned by the connector or partner, ex. `apiexemple`. required: true style: form schema: type: string example: apiexemple - name: Content-Type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json requestBody: description: Body of the request to execute the Full update connector. content: application/json: schema: $ref: '#/components/schemas/fullUpdateConnector' responses: '200': description: OK headers: {} deprecated: false patch: tags: - External Marketplace summary: VTex Partial update connector description: Partially updates the connector's information. The payload follows the format defined by RFC 6902, where a list of operations is informed, including the path of the field inside the object and its value./n/nThis action can only be executed by the account name that owns the connector's registration. operationId: partial-update-connector parameters: - name: environment in: path description: Environment used as part of URL. required: true style: simple schema: type: string example: https://portal.vtexcommercestable.com.br - name: connectorId in: path description: Connector's ID in Channel Manager, available through the list all connectors route, or in the response of the registration. required: true style: simple schema: type: number example: 46 - name: an in: query description: VTEX's account name owned by the connector/partner, ex. `apiexemple`. required: true style: form schema: type: string example: apiexemple - name: Accept in: header description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: Content-type in: header description: Required header to indicate the request is a PATCH. required: true style: simple schema: type: string default: application/json-patch+json requestBody: description: Body of the request to execute the Partial update connector call. content: application/json: schema: $ref: '#/components/schemas/partialUpdateConnector' responses: '200': description: OK headers: {} deprecated: false /api/fulfillment/pvt/orders: post: tags: - External Marketplace summary: VTex Place fulfillment order description: "Creates fulfillment order, meaning that it is an order for the seller's side in a sale made through a marketplace. This order assumes the transaction itself has already happened on the marketplace's side and, therfore, cares only about the fulfillment side.\n\r\n\r> If you plan to integrate external orders with possible [Price divergence](https://help.vtex.com/en/tutorial/price-divergence-rule--6RlFLhD1rIRRshl83KnCjW#) be mindful of the `isCreatedAsync` request body field. \n\nFor a detailed explanation of the steps required to develop a custom connector to become an external marketplace for VTEX sellers, check out our complete [External Marketplace Integration Guide](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-guide)." operationId: PlaceFulfillmentOrder parameters: - name: accountName in: path required: true description: Name of the VTEX account. Used as part of the URL. schema: type: string default: apiexamples - name: environment in: path required: true description: Environment to be used. It is passed as part of the URL. schema: type: string default: vtexcommercestable - name: Content-Type in: header description: Type of the content being sent. required: true style: simple schema: type: string default: application/json - name: Accept in: header description: HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: sc in: query description: Sales channel. required: false style: form schema: type: string example: '1' - name: affiliateId in: query description: ID identifying the marketplace where the order originates. This ID is configured in the seller's VTEX account, and should be informed to the marketplace. required: true style: form schema: type: string example: MKP requestBody: content: application/json: schema: type: object required: - marketplaceOrderId - marketplaceServicesEndpoint - marketplacePaymentValue - items - clientProfileData - shippingData properties: marketplaceOrderId: type: string description: ID of the order in the marketplace. example: '123456789' marketplaceServicesEndpoint: type: string description: Endpoint provided by the marketplace for post purchase communication. Should be an URL, containing protocol, host, path and query string (in case it applies). example: https://exampleseller.marketplaceservices.com marketplacePaymentValue: type: integer description: Value of the payment made to the marketplace. example: 100 isCreatedAsync: type: boolean description: Indicates whether an order is created. It must be `true` if an order is being placed with [Price divergence](https://help.vtex.com/en/tutorial/configuring-price-divergence-rule--awAKP0sS5J8jgLs2g7pPe), otherwise the request will not work. example: false items: type: array description: Array of objects containing information on each of the order's items. items: type: object required: - id - quantity - seller properties: id: type: string description: The SKU ID. example: '123' quantity: type: integer format: int32 description: The quantity of items of this specific SKU in the cart to be simulated. example: 1 seller: type: string description: The ID of the seller responsible for this SKU. This ID can be found in your VTEX Admin. example: '1' commission: type: integer description: Comission. example: 10 freightCommission: type: integer description: Freight comission example: 10 price: type: integer description: Item price within the context of the order without separating cents. For example, $24.99 is represented `2499`. example: 2499 bundleItems: type: array description: 'Information on services sold along with the SKU. Example: a gift package.' items: type: object properties: type: type: string description: Service type. example: type-example id: type: integer description: Service identifier. example: 1034 name: type: string description: Service name. example: name-example price: type: integer description: Service price. The last two digits are the cents. example: 199 itemAttachment: type: object description: Item attachment. properties: name: type: string description: Attachment name. example: name-example content: type: string description: Content referring to the customization requested by the customer. example: content-example attachments: type: array description: Array containing information on attachments. items: type: string priceTags: type: array description: Array of price tags, each of which, modifies the price in some way, like discounts or rates that apply to the item in the context of the order. items: type: object properties: identifier: type: string description: Price tag identifier. example: 1234abc-5678b-1234c isPercentual: type: boolean description: '`true` if price tag value is applied through a percentage.' default: false name: type: string description: Price tag name. example: discount@name-1234abc-5678b-1234c rawValue: type: integer description: Price tag value. example: -12 value: type: integer description: Price tag raw value. example: -1200 measurementUnit: type: string description: SKU measurement unit. example: g unitMultiplier: type: integer description: SKU unit multiplier. example: 1 isGift: type: boolean description: Indicates whether the order is a gift. default: false example: id: '123456789' quantity: 1 seller: '1' clientProfileData: type: object description: Customer's profile information. required: - email - firstName - lastName - documentType - document properties: email: type: string description: Customer's email address. example: customer@examplemail.com firstName: type: string description: Customer's first name. example: first-name lastName: type: string description: Customer's last name. example: last-name documentType: type: string description: Type of the document informed by the customer. example: cpf document: type: string description: Document informed by the customer. Validation depends on the country. example: '123456789' phone: type: string description: Customer's phone number. example: '+55110988887777' corporateName: type: string description: Company name, if the customer is a legal entity. example: company-name nullable: true tradeName: type: string description: Trade name, if the customer is a legal entity. example: trade-name nullable: true corporateDocument: type: string description: Corporate document, if the customer is a legal entity. example: '12345678000100' nullable: true stateInscription: type: string description: State inscription, if the customer is a legal entity. example: '12345678' nullable: true corporatePhone: type: string description: Corporate phone number, if the customer is a legal entity. example: '+551100988887777' nullable: true isCorporate: type: boolean description: '`true` if the customer is a legal entity.' example: false nullable: true shippingData: type: object description: Shipping information. properties: address: type: object description: Shipping address. required: - addressType - receiverName - postalCode - city - state - country - street - number properties: addressType: type: string description: Type of address. For example, `Residential` or `Pickup`, among others. example: residential receiverName: type: string description: Name of the person who is going to receive the order. example: receiver-name addressId: type: string description: Address ID. example: Home postalCode: type: string description: Postal Code. Validation depends on the country. example: '12345000' city: type: string description: City of the shipping address. example: Rio de Janeiro state: type: string description: State of the shipping address. example: Rio de Janeiro country: type: string description: Three letter ISO code of the country of the shipping address. example: BRA street: type: string description: Street of the shipping address. example: Praia de Botafogo number: type: string description: Number of the building, house or apartment in the shipping address. example: '300' neighborhood: type: string description: Neighborhood of the shipping address. example: Botafogo complement: type: string description: Complement to the shipping address in case it applies. example: 3rd floor reference: type: string description: Complement that might help locate the shipping address more precisely in case of delivery. example: Grey building geoCoordinates: type: array description: Array with two strings with geocoordinates, first latitude, then longitude. items: type: string example: '00.00000' logisticsInfo: type: array description: Array of objects containing logistics information of each item. items: type: object required: - itemIndex - selectedSla - price properties: itemIndex: type: integer description: Index of the item in the `items` array, starting from 0. example: 0 selectedSla: type: string description: Selected shipping option example: Express lockTTL: type: string description: Logistics reservation waiting time. example: 8d shippingEstimate: type: string description: Estimated time until delivery for the item. example: 7d price: type: integer description: Shipping price for the item. Does not account for the whole order's shipping price. example: 1099 deliveryWindow: type: object description: In case of scheduled delivery, this object will contain information on the delivery window selected by the shopper. properties: startDateUtc: type: string description: Delivery window starting day and time in UTC. example: '2021-07-13T00:00:00+00:00' endDateUtc: type: string description: Delivery window ending day and time in UTC. example: '2021-07-13T23:59:59+00:00' price: type: integer description: Delivery window price. default: 0 lisPrice: type: integer description: Delivery window list price. default: 0 tax: type: integer description: Delivery window tax. default: 0 updateStatus: type: string description: Indicate whether this object's information is up to date according to the order's items. An order can not be placed if `"outdated"` example: updated paymentData: type: object description: In other contexts, this field tipically holds an object with payment information. However, since the payment is processed by the marketplace, it will be sent to the seller as `null` in this context. nullable: true default: null marketingData: type: object properties: utmSource: type: string description: UTM source. example: Facebook utmMedium: type: string description: UTM medium. example: CPC utmCampaign: type: string description: UTM campaign example: Black friday utmiPage: type: string description: utmi_page (internal utm) example: utmi_page-example utmiPart: type: string description: utmi_part (internal utm) example: utmi_part-exmaple utmiCampaign: type: string description: utmi_campaign (internal utm) example: utmi_campaign-exmaple openTextField: type: string description: Optional field meant to hold additional information about the order. We recommend using this field for text, not data formats such as `JSON` even if escaped. For that purpose, see [Creating customizable fields](https://developers.vtex.com/vtex-rest-api/docs/creating-customizable-fields-in-the-cart-with-checkout-api-1) example: open-text-example responses: '200': description: OK headers: {} content: application/json: examples: response: value: - marketplaceOrderId: '956' orderId: MBR-956 followUpEmail: 9762a2a9028a4b5d8eb9a8ff909d15ce@ct.vtex.com.br items: - id: '2' quantity: 1 seller: '1' priceTable: null comission: 0 freightComission: 0 price: 13890 bundleItems: [] priceTags: [] measurementUnit: un unitMultiplier: 1 isGift: false clientProfileData: email: fba45537f5c84d4092cf064da742fe3d@ct.vtex.com.br firstName: Júlio lastName: Augusto de Oliveira documentType: cpf document: '11417984642' phone: '395555258' corporateName: null tradeName: null corporateDocument: null stateInscription: null corporatePhone: null isCorporate: false userProfileId: null shippingData: isFOB: false address: addressType: Residencial receiverName: Júlio Augusto de Oliveira addressId: Casa postalCode: '98776003' city: Americana state: SP country: BRA street: Rua da casa number: '31187' neighborhood: Grande circo complement: null reference: Bairro do foca / Posto de Saúde 65 geoCoordinates: [] selectedaddresses: - addressType: Residencial receiverName: Júlio Augusto de Oliveira addressId: Casa postalCode: '98776003' city: Americana state: SP country: BRA street: Rua da casa number: '31187' neighborhood: Grande circo complement: null reference: Bairro do foca / Posto de Saúde 65 geoCoordinates: [] logisticsInfo: - itemIndex: 0 selectedSla: Correios addressId: Casa selectedDeliveryChannel: delivery deliveryIds: - warehouseId: '1_1' dockId: '1' lockTTL: 8d shippingEstimate: 7d price: 1090 deliveryWindow: null trackingHints: [] paymentData: null customData: null deprecated: false /api/fulfillment/pvt/orders/{orderId}/fulfill: post: tags: - External Marketplace summary: VTex Authorize dispatch for fulfillment order description: "Creates fulfillment order, meaning that it is an order for the seller's side in a sale made through a marketplace. This order assumes the transaction itself has already happened on the marketplace's side and, therfore, cares only about the fulfillment side. \n\nFor a detailed explanation of the steps required to develop a custom connector to become an external marketplace for VTEX sellers, check out our complete [External Marketplace Integration Guide](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-guide)." operationId: AuthorizeDispatchForFulfillmentOrder parameters: - name: accountName in: path required: true description: Name of the VTEX account. Used as part of the URL. schema: type: string default: apiexamples - name: environment in: path required: true description: Environment to be used. It is passed as part of the URL. schema: type: string default: vtexcommercestable - name: orderId in: path required: true description: ID of the order that is to be authorized. It is composed of the `afilliateId` and the `marketplaceOrderId` joined with a `-`. For instance, an order with an ID `"123"` coming from the marketplace `"MKP"` has an `orderId` of `"MKP-123"`. schema: type: string default: MKP-123 - name: Content-Type in: header description: Type of the content being sent. required: true style: simple schema: type: string default: application/json - name: Accept in: header description: HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: sc in: query description: Sales channel. required: false style: form schema: type: string example: '1' - name: affiliateId in: query description: ID identifying the marketplace where the order originates. This ID is configured in the seller's VTEX account, and should be informed to the marketplace. required: true style: form schema: type: string example: MKP requestBody: content: application/json: schema: type: object properties: marketplaceOrderId: type: string description: ID of the order in the marketplace. It is the same as the `orderId` without the `afilliateId` at the beginning. For instance, if the `orderId` is `"MKP-123"`, the `marketplaceOrderId` is `"123"`. default: '123' responses: '200': description: OK headers: {} content: application/json: examples: response: value: marketplaceOrderId: '123' deprecated: false /api/order-integration/orders: post: tags: - External Marketplace summary: VTex New Order Integration description: "API to integrate an external channel's order into the VTEX plataform.\n\nThis process is asynchronous and a notification with the order's integration results will be sent to the endpoint specified in the **connectorEndpoint** field in [App Template](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-app-template), if the connector uses our App template. The field **connectorName** is also optional for connectors that use our App Template and authenticate using the app's auth cookie. If the account is not informed in the URL host, it should also be defined as a query string parameter in the route: `an={account}`. \n\nFor a detailed explanation of the steps required to develop a custom connector to become an external marketplace for VTEX sellers, check out our complete [External Marketplace Integration Guide](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-guide)." operationId: EnqueueNewOrder parameters: - name: Content-Type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json - name: Accept in: header description: HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: an in: query description: Parameter should indicate the name of the VTEX account where the order is being integrated or updated, meaning the seller responsible for the order. required: false style: form explode: true schema: type: string example: apiexamples - name: accountName in: path required: true description: Parameter should indicate the name of the VTEX account where the order is being integrated or updated, meaning the seller responsible for the order. schema: type: string default: apiexamples - name: affiliateId in: query description: ID identifying the marketplace where the order originates. This ID is configured in the seller's VTEX account, and should be informed to the marketplace. required: true style: form explode: true schema: type: string example: MKP requestBody: description: '' content: application/json: schema: $ref: '#/components/schemas/EnqueueNewOrderRequest' example: marketplaceOrderId: '{{$guid}}' marketplaceOrderStatus: NEW marketplacePaymentValue: 3025 connectorName: SkyHub connectorEndpoint: https://connector-endpoint.com/api/vtex allowFranchises: false pickupAccountName: '' items: - id: '1' price: 975 quantity: 1 clientProfileData: email: email@email.com.br firstName: John lastName: Doe phone: '99999999999' document: '99999999999' corporateDocument: null corporatePhone: null corporateName: null tradeName: null stateInscription: null shippingData: logisticsInfo: - price: 2050 selectedDeliveryChannel: delivery selectedSla: Express lockTTL: 1d shippingEstimate: 2d deliveryIds: warehouseId: AR1 selectedAddresses: - addressType: Residential addressId: '1' receiverName: John Doe postalCode: 81020-235 city: Curitiba state: PR country: BRA street: Rua Eduardo Carlos Pereira number: '4125' neighborhood: Portão complement: '101' geoCoordinates: latitude: '-29.5' longitude: '-45.8' isFob: true isMarketplaceFulfillment: true invoiceData: userPaymentInfo: paymentMethods: - creditCardPaymentGroup customData: customApps: - id: marketplace-integration major: 1 fields: marketplacePaymentMethod: credit card required: true responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/Deliverybyseller' example: marketplaceOrderId: null accountName: grocery1 code: SOI003 flow: PlaceOrder success: true operationId: null errors: null fields: null message: Order successfully enqueued default: description: '' headers: {} content: application/json: schema: $ref: '#/components/schemas/Deliverybyfranchiseseller' example: marketplaceOrderId: null accountName: grocery1 code: SOI003 flow: PlaceOrder success: true operationId: null errors: null fields: null message: Order successfully enqueued deprecated: false /api/order-integration/orders/status: put: tags: - External Marketplace summary: VTex Update Order Status description: "API request used to update an order status in VTEX.\n\nThis process is asynchronous and a notification with the order's integration results will be sent to the endpoint specified in the **connectiorEndpoint** field or the **connectiorEndpoint** [App Template](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-app-template), if the connector uses our App template. The field **connectorName** is also optional for connectors that use our App Template and authenticate using the app's auth cookie. \n\nFor a detailed explanation of the steps required to develop a custom connector to become an external marketplace for VTEX sellers, check out our complete [External Marketplace Integration Guide](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-guide)." operationId: UpdateOrderStatus parameters: - name: Content-Type in: header description: Describes the type of the content being sent. required: true style: simple schema: type: string default: application/json - name: Accept in: header description: HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: an in: query description: Parameter should indicate the name of the VTEX account where the order is being integrated or updated, meaning the seller responsible for the order. required: false style: form explode: true schema: type: string example: apiexamples - name: accountName in: path required: true description: Parameter should indicate the name of the VTEX account where the order is being integrated or updated, meaning the seller responsible for the order. schema: type: string default: apiexamples requestBody: description: '' content: application/json: schema: $ref: '#/components/schemas/UpdateOrderStatusRequest' example: marketplaceOrderId: '{{$guid}}' marketplaceOrderStatus: APPROVED connectorName: Skyhub connectorEndpoint: https://connector-endpoint.com/api/vtex required: true responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/Approveorder' example: marketplaceOrderId: 7e62fcd3-827b-400d-be8a-f050a79c4976 accountName: null code: SOI003 flow: ApproveOrder success: true operationId: null errors: null fields: null message: Order successfully enqueued deprecated: false /api/checkout/pub/orderForms/simulation: post: tags: - External Marketplace summary: VTex Fulfillment simulation - External Marketplace description: "This endpoint can be triggered by marketplaces to simulate the fulfillment of an item in the cart.\r\n\r\nThe fulfillment information is useful whenever you need to know the availability of fulfilling an order for a specific cart setting, since the API response will let you know the updated price, inventory and shipping data." operationId: fulfillment-simulation-external-marketplace parameters: - name: accountName in: path required: true description: Name of the VTEX account. Used as part of the URL. schema: type: string default: apiexamples - name: environment in: path required: true description: Environment to be used. It is passed as part of the URL. schema: type: string default: vtexcommercestable - name: Content-Type in: header description: Type of the content being sent. required: true style: simple schema: type: string default: application/json - name: Accept in: header description: HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand. required: true style: simple schema: type: string default: application/json - name: affiliateId in: query description: The affiliate ID code created by the seller. required: false style: form schema: type: string default: MNF - name: sc in: query description: Trade Policy (Sales Channel) identification. required: false style: form schema: type: integer example: 1 requestBody: content: application/json: schema: type: object required: - id - quantity - seller properties: items: type: array description: Array containing information about the SKUs inside the cart to be simulated. items: type: object properties: id: type: string description: The SKU ID. example: '1' quantity: type: integer format: int32 description: The quantity of items of this specific SKU in the cart to be simulated. example: 1 seller: type: string description: The ID of the seller responsible for this SKU. This ID can be found in your VTEX Admin. example: '1' marketingData: type: object description: Object containing promotion data such as coupon tracking information and internal or external UTMs. properties: coupon: type: string description: Sending an existing coupon code in this field will return the corresponding discount in the purchase. Use the [cart simulation](https://developers.vtex.com/vtex-rest-api/reference/orderform#orderformsimulation) request to check which coupons might apply before placing the order. default: free-shipping utmSource: type: string description: UTM source. default: Facebook utmMedium: type: string description: UTM medium. default: CPC utmCampaign: type: string description: UTM campaign default: Black friday utmiPage: type: string description: utmi_page (internal utm). default: utmi_page-example utmiPart: type: string description: utmi_part (internal utm). default: utmi_part-example utmiCampaign: type: string description: utmi_campaign (internal utm). default: utmi_campaign-example postalCode: type: string description: Postal code. example: 12345-000 country: type: string description: Three letter ISO code of the country of the shipping address. This value must be sent along with the `postalCode` or `geoCoordinates` values. example: BRA selectedSla: type: string description: SLA selected by the customer. example: Normal clientProfileData: type: object description: Customer's profile information. properties: email: type: string description: Email address. example: clark.kent@example.com firstName: type: string description: First name. example: Clark lastName: type: string description: Last name. example: Kent documentType: type: string description: Type of the document informed by the customer. example: cpf document: type: string description: Document informed by the customer. example: '12345678900' phone: type: string description: Phone number. example: '+552199999999' corporateName: type: string description: Company name, if the customer is a legal entity. nullable: true tradeName: type: string description: Trade name, if the customer is a legal entity. nullable: true corporateDocument: type: string description: Corporate document, if the customer is a legal entity. nullable: true stateInscription: type: string description: State inscription, if the customer is a legal entity. nullable: true corporatePhone: type: string description: Corporate phone number, if the customer is a legal entity. nullable: true isCorporate: type: boolean description: Indicates whether the customer is a legal entity. profileCompleteOnLoading: type: boolean description: Indicates whether profile is complete on loading. profileErrorOnLoading: type: boolean description: Indicates whether profile presents error on loading. nullable: true customerClass: type: string description: Customer class. nullable: true geoCoordinates: type: array description: Array containing two floats with geocoordinates, first longitude, then latitude. default: - -47.924747467041016 - -15.832582473754883 items: type: number example: -47.924747467041016 isCheckedIn: type: boolean description: Indicates whether order is checked in. default: false storeId: type: string description: ID of the store. nullable: true responses: '200': description: OK headers: {} content: application/json: schema: type: object properties: items: type: array description: Information on each item in the cart. items: type: object properties: id: type: string description: ID of the item. requestIndex: type: integer description: Request index information. quantity: type: integer description: The quantity of the item the cart. seller: type: string description: The seller responsible for the SKU. sellerChain: type: array description: Sellers involved in the chain. The list should contain only one seller, unless it is a [Multilevel Omnichannel Inventory](https://help.vtex.com/en/tutorial/multilevel-omnichannel-inventory--7M1xyCZWUyCB7PcjNtOyw4) order. items: type: string description: Seller. tax: type: integer description: Tax value in cents. priceValidUntil: type: string description: Price expiration date and time. price: type: integer description: Price in cents. listPrice: type: integer description: List price in cents. rewardValue: type: integer description: Reward value in cents. sellingPrice: type: integer description: Selling price in cents. Note that this field may be subject to rounding discrepancies. We recommend retrieving data from the `priceDefinition` data structure instead. offerings: type: array description: Array containing offering information. priceTags: type: array description: Array of price tags, each of which, modifies the price in some way, like discounts or rates that apply to the item in the context of the order. items: type: object properties: name: type: string description: Price tag name. value: type: integer description: Price tag value. rawValue: type: integer description: Price tag raw value. isPercentual: type: boolean description: Indicates whether price tag value is applied through a percentage. identifier: type: string description: Price tag identifier. owner: type: string description: Identification of the responsible for the price tag. measurementUnit: type: string description: Measurement unit. unitMultiplier: type: integer description: Unit multiplier. parentItemIndex: type: integer description: Parent item index. nullable: true parentAssemblyBinding: type: string description: Parent assembly binding. nullable: true availability: type: string description: Availability. priceDefinition: type: object description: Price information for all units of a specific item. properties: calculatedSellingPrice: type: integer description: Item's calculated unitary selling price in cents. total: type: integer description: Total value for all units of the item in cents. sellingPrices: type: array description: Array of objects, each containing value (in cents) and quantity for the different rounding instances that can be combined to form the correctly rounded total. items: type: object properties: value: type: integer description: Value in cents for that specific rounding. quantity: type: integer description: Rounding quantity, meaning how many items are rounded to this value. ratesAndBenefitsData: type: object description: Information on rates and benefits that apply to the order. properties: rateAndBenefitsIdentifiers: type: array description: List with rates and benefits identifiers. teaser: type: array description: List with rates and benefits teasers. paymentData: type: object description: Payment data information. properties: installmentOptions: type: array description: Installment options information. properties: paymentSystem: type: integer description: Payment system identification. bin: type: string description: Bin. nullable: true paymentName: type: string description: Payment name. paymentGroupName: type: string description: Payment group name. value: type: integer description: Total value assigned to this payment. installments: type: array description: Installments information. properties: count: type: integer description: Count information. hasInterestRate: type: boolean description: Indicates whether the payment has interest. interestRate: type: integer description: Interest rate value. value: type: integer description: Value of the order without the interest rate. The value is shown without separating cents. total: type: integer description: Total value of the order without separating cents. For example, $24.99 is represented `2499`. sellerMerchantInstallments: type: array description: Seller merchant installments information. paymentSystems: type: array description: Information on payment systems. items: type: object properties: id: type: integer description: Payment system ID. name: type: string description: Payment system name. groupName: type: string description: Payment group name. validator: type: object description: Payment system validator. nullable: true stringId: type: string description: String ID. template: type: string description: Template. requiresDocument: type: boolean description: Indicates whether a document is required. displayDocument: type: boolean description: Indicates whether a document is shown. isCustom: type: boolean description: Indicates whether it is custom. description: type: string description: Description. requiresAuthentication: type: boolean description: Indicates whether a authentication is required. dueDate: type: string description: Payment due date. availablePayments: type: string description: Availability of payment. nullable: true payments: type: array description: Information on each payment. giftCards: type: array description: Gift card information, if it applies to the order. giftCardMessages: type: array description: Array of gift card messages. availableAccounts: type: array description: Available accounts. availableTokens: type: array description: Available tokens. availableAssociations: type: object description: Available associations. selectableGifts: type: array description: Array containing the data of the item selected as a gift. marketingData: type: object description: Object containing promotion data such as coupon tracking information and internal or external UTMs. nullable: true postalCode: type: string description: Postal Code. nullable: true country: type: string description: Three letter ISO code of the country of the shipping address. logisticsInfo: type: array description: Array with logistics information on each item of the `items` array in the `orderForm`. items: type: object properties: itemIndex: type: integer description: Index of item in items array. addressId: type: string description: Address ID. nullable: true selectedSla: type: string description: Selected SLA. For example, `"normal"` or `"express"`. nullable: true selectedDeliveryChannel: type: string description: Delivery channel selected by the customer. For example, `"delivery"` or `"pickup-in-point"`. nullable: true quantity: type: integer description: Quantity. shipsTo: type: array description: List of countries that the item may be shipped to. slas: type: array description: Information on available SLAs. items: type: object properties: id: type: string description: SLA ID. deliveryChannel: type: string description: Delivery channel. name: type: string description: SLA name. deliveryIds: type: array description: Information on each delivery ID. items: type: object properties: courierId: type: string description: Courier ID. warehouseId: type: string description: Warehouse ID. dockId: type: string description: Warehouse ID. courierName: type: string description: Courier name. quantity: type: integer description: Quantity. shippingEstimate: type: string description: Shipping estimate. For instance, "three business days" will be represented as `3bd`. shippingEstimateDate: type: string description: Shipping estimate date. nullable: true lockTTL: type: string description: Estimate date of delivery. availableDeliveryWindows: type: object description: This object contains information about the delivery window available to the shopper. properties: startDateUtc: type: string description: Delivery window starting day and time in UTC. endDateUtc: type: string description: Delivery window ending day and time in UTC. price: type: integer description: Delivery window price. lisPrice: type: integer description: Delivery window list price. tax: type: integer description: Delivery window tax. deliveryWindow: type: object description: In case of scheduled delivery, this object will contain information on the delivery window selected by the shopper. properties: startDateUtc: type: string description: Delivery window starting day and time in UTC. endDateUtc: type: string description: Delivery window ending day and time in UTC. price: type: integer description: Delivery window price. lisPrice: type: integer description: Delivery window list price. tax: type: integer description: Delivery window tax. price: type: integer description: Price in cents. listPrice: type: integer description: List price in cents. tax: type: integer description: Tax in cents. pickupStoreInfo: type: object description: Information on the pickup store. properties: isPickupStore: type: boolean description: Indicates whether it is the pickup store. friendlyName: type: string description: Friendly name. nullable: true address: type: object description: Address information. nullable: true additionalInfo: type: string description: Additional information. nullable: true dockId: type: string description: Corresponding dock ID. nullable: true pickupPointId: type: string description: Pickup point ID. nullable: true pickupDistance: type: integer description: Pickup point distance. polygonName: type: string description: Polygon name. nullable: true transitTime: type: string description: Transit time. For instance, "three business days" is represented as `3bd`. deliveryChannels: type: array description: List of available delivery channels. items: type: object properties: id: type: string description: Delivery channel ID. messages: type: array description: Array containing an object for each message generated by our servers while processing the request. purchaseConditions: type: object description: Purchase conditions information. properties: itemPurchaseConditions: type: array description: List of objects containing purchase condition information on each item in the order. items: type: object properties: id: type: string description: Item ID. seller: type: string description: Seller. sellerChain: type: array description: Sellers involved in the chain. The list should contain only one seller, unless it is a [Multilevel Omnichannel Inventory](https://help.vtex.com/en/tutorial/multilevel-omnichannel-inventory--7M1xyCZWUyCB7PcjNtOyw4) order. slas: type: array description: Information on available SLAs. items: type: object properties: id: type: string description: SLA ID. deliveryChannel: type: string description: Delivery channel. name: type: string description: SLA name. deliveryIds: type: array description: Information on each delivery ID. items: type: object properties: courierId: type: string description: Courier ID. warehouseId: type: string description: Warehouse ID. dockId: type: string description: Warehouse ID. courierName: type: string description: Courier name. quantity: type: integer description: Quantity. shippingEstimate: type: string description: Shipping estimate. For instance, "three business days" will be represented as `3bd`. shippingEstimateDate: type: string description: Shipping estimate date. nullable: true lockTTL: type: string description: Estimate date of delivery. availableDeliveryWindows: type: object description: This object contains information about the delivery window available to the shopper. properties: startDateUtc: type: string description: Delivery window starting day and time in UTC. endDateUtc: type: string description: Delivery window ending day and time in UTC. price: type: integer description: Delivery window price. lisPrice: type: integer description: Delivery window list price. tax: type: integer description: Delivery window tax. deliveryWindow: type: object description: In case of scheduled delivery, this object will contain information on the delivery window selected by the shopper. properties: startDateUtc: type: string description: Delivery window starting day and time in UTC. endDateUtc: type: string description: Delivery window ending day and time in UTC. price: type: integer description: Delivery window price. lisPrice: type: integer description: Delivery window list price. tax: type: integer description: Delivery window tax. price: type: integer description: Price in cents. listPrice: type: integer description: List price in cents. tax: type: integer description: Tax in cents. pickupStoreInfo: type: object description: Information on the pickup store. properties: isPickupStore: type: boolean description: Indicates whether it is the pickup store. friendlyName: type: string description: Friendly name. nullable: true address: type: object description: Address information. nullable: true additionalInfo: type: string description: Additional information. nullable: true dockId: type: string description: Corresponding dock ID. nullable: true pickupPointId: type: string description: Pickup point ID. nullable: true pickupDistance: type: integer description: Pickup point distance. polygonName: type: string description: Polygon name. nullable: true transitTime: type: string description: Transit time. For instance, "three business days" is represented as `3bd`. price: type: integer description: Price in cents. listPrice: type: integer description: List price in cents. pickupPoints: type: array description: Array containing pickup points information. subscriptionData: type: object description: Subscription information. nullable: true totals: type: array description: Information on order totals. items: type: object properties: id: type: string description: Total ID. name: type: string description: Total name. value: type: integer description: Total value. itemMetadata: type: object description: Item metadata. properties: items: type: array description: List of objects containing metadata on each item in the order. items: type: object properties: id: type: string description: Item ID. seller: type: string description: Seller. assemblyOptions: type: array description: Assembly options information. properties: id: type: string description: Item ID. name: type: string description: Item name. required: type: boolean description: Indicates whether the item is required. inputValues: type: object description: Input values information. composition: type: string description: Composition information. nullable: true example: items: - id: '1' requestIndex: 0 quantity: 1 seller: '1' sellerChain: - '1' tax: 0 priceValidUntil: '2023-07-12T11:49:01Z' price: 9999 listPrice: 9999 rewardValue: 0 sellingPrice: 2999700 offerings: [] priceTags: - name: DISCOUNT@MANUALPRICE value: -5000 rawValue: -50 isPercentual: false identifier: 1234abc-5678b-1234c measurementUnit: un unitMultiplier: 300 parentItemIndex: null parentAssemblyBinding: null availability: available priceDefinition: calculatedSellingPrice: 2999700 total: 2999700 sellingPrices: - value: 2999700 quantity: 1 ratesAndBenefitsData: rateAndBenefitsIdentifiers: [] teaser: [] paymentData: installmentOptions: - paymentSystem: '2' bin: null paymentName: Visa paymentGroupName: creditCardPaymentGroup value: 2999700 installments: - count: 1 hasInterestRate: false interestRate: 0 value: 2999700 total: 2999700 sellerMerchantInstallments: - id: LOJADOBRENO count: 1 hasInterestRate: false interestRate: 0 value: 2999700 total: 2999700 - paymentSystem: '6' bin: null paymentName: Boleto Bancário paymentGroupName: bankInvoicePaymentGroup value: 2999700 installments: - count: 1 hasInterestRate: false interestRate: 0 value: 2999700 total: 2999700 sellerMerchantInstallments: - id: LOJADOBRENO count: 1 hasInterestRate: false interestRate: 0 value: 2999700 total: 2999700 - paymentSystem: '127' bin: null paymentName: MercadoPagoPro paymentGroupName: MercadoPagoProPaymentGroup value: 2999700 installments: - count: 1 hasInterestRate: false interestRate: 0 value: 2999700 total: 2999700 sellerMerchantInstallments: - id: LOJADOBRENO count: 1 hasInterestRate: false interestRate: 0 value: 2999700 total: 2999700 - paymentSystem: '202' bin: null paymentName: Dinheiro paymentGroupName: custom202PaymentGroupPaymentGroup value: 2999700 installments: - count: 1 hasInterestRate: false interestRate: 0 value: 2999700 total: 2999700 sellerMerchantInstallments: - id: LOJADOBRENO count: 1 hasInterestRate: false interestRate: 0 value: 2999700 total: 2999700 paymentSystems: - id: 202 name: Dinheiro groupName: custom202PaymentGroupPaymentGroup validator: null stringId: '202' template: custom202PaymentGroupPaymentGroup-template requiresDocument: false displayDocument: false isCustom: true description: '' requiresAuthentication: false dueDate: '2022-07-22T11:39:36.37197Z' availablePayments: null - id: 6 name: Boleto Bancário groupName: bankInvoicePaymentGroup validator: null stringId: '6' template: bankInvoicePaymentGroup-template requiresDocument: false displayDocument: false isCustom: false description: '' requiresAuthentication: false dueDate: '2022-07-19T11:39:36.37197Z' availablePayments: null - id: 2 name: Visa groupName: creditCardPaymentGroup validator: null stringId: '2' template: creditCardPaymentGroup-template requiresDocument: false displayDocument: false isCustom: false description: '' requiresAuthentication: false dueDate: '2022-07-19T11:39:36.37197Z' availablePayments: null - id: 127 name: MercadoPagoPro groupName: MercadoPagoProPaymentGroup validator: null stringId: '127' template: MercadoPagoProPaymentGroup-template requiresDocument: false displayDocument: false isCustom: false description: '' requiresAuthentication: false dueDate: '2022-07-19T11:39:36.37197Z' availablePayments: null payments: [] giftCards: [] giftCardMessages: [] availableAccounts: [] availableTokens: [] availableAssociations: {} selectableGifts: [] marketingData: utmSource: app utmMedium: CPC utmCampaign: Black friday utmipage: 'true' utmiPart: 'true' utmiCampaign: 'true' coupon: null marketingTags: - tag1 - tag2 country: BRA postalCode: 12345-000 geoCoordinates: - -47.924747467041016 - -15.832582473754883 logisticsInfo: - itemIndex: 0 addressId: null selectedSla: null selectedDeliveryChannel: null quantity: 1 shipsTo: - BRA slas: - id: Normal deliveryChannel: delivery name: Normal deliveryIds: - courierId: '1' warehouseId: '1_1' dockId: '1' courierName: Transportadora quantity: 1 kitItemDetails: [] shippingEstimate: 3bd shippingEstimateDate: null lockTTL: 10d availableDeliveryWindows: startDateUtc: '2017-03-27T00:00:00+00:00' endDateUtc: '2017-03-27T00:00:00+00:00' price: 0 lisPrice: 0 tax: 0 deliveryWindow: startDateUtc: '2014-04-21T09:00:00+00:00' endDateUtc: '2014-04-21T12:00:00+00:00' price: 0 listprice: 1000 tax: 0 price: 1500 listPrice: 1500 tax: 0 pickupStoreInfo: isPickupStore: false friendlyName: null address: null additionalInfo: null dockId: null pickupPointId: null pickupDistance: 0 polygonName: null transitTime: 3bd deliveryChannels: - id: pickup-in-point - id: delivery messages: [] purchaseConditions: itemPurchaseConditions: - id: '1' seller: '1' sellerChain: - '1' slas: - id: Normal deliveryChannel: delivery name: Normal deliveryIds: - courierId: '1' warehouseId: '1_1' dockId: '1' courierName: Transportadora quantity: 1 kitItemDetails: [] shippingEstimate: 3bd shippingEstimateDate: null lockTTL: 10d availableDeliveryWindows: startDateUtc: '2017-03-27T00:00:00+00:00' endDateUtc: '2017-03-27T00:00:00+00:00' price: 0 lisPrice: 0 tax: 0 deliveryWindow: startDateUtc: '2014-04-21T09:00:00+00:00' endDateUtc: '2014-04-21T12:00:00+00:00' price: 0 listprice: 1000 tax: 0 price: 1500 listPrice: 1500 tax: 0 pickupStoreInfo: isPickupStore: false friendlyName: null address: null additionalInfo: null dockId: null pickupPointId: null pickupDistance: 0 polygonName: null transitTime: 3bd price: 9999 listPrice: 9999 pickupPoints: [] subscriptionData: null totals: - id: Items name: Total dos Itens value: 2999700 itemMetadata: items: - id: '1' seller: '1' assemblyOptions: - id: T-Shirt Customization name: T-Shirt Customization required: false inputValues: T-Shirt Name: maximumNumberOfCharacters: 2 domain: - '[]' composition: null deprecated: false components: schemas: upsertMerchantConnection: title: Upsert merchant connection required: - isActive - affiliateId type: object properties: isActive: type: boolean default: false affiliateId: type: string default: '' Fields: title: Fields description: String dictionary with the names of the fields and their respective values that must be inserted into the order. required: - marketplacePaymentMethod type: object properties: marketplacePaymentMethod: type: string title: marketplacePaymentMethod description: String with field's key and value. example: credit card example: marketplacePaymentMethod: credit card Deliverybyseller: title: Deliverybyseller required: - marketplaceOrderId - accountName - code - flow - success - operationId - errors - fields - message type: object properties: marketplaceOrderId: type: string nullable: true description: String that indicates the order's ID in the marketplace. example: 7e62fcd3-827b-400d-be8a-f050a79c4976 accountName: type: string description: String that indicates which account made the request. example: accountName code: type: string description: String with a internal Channel Order API code that classifies the response. The possible values returned in this field are described in the [Response Codes]() section. example: SOI001 flow: type: string description: "String containing the name of the flow responsible for the response. This field can contain the following values: \n\n`PlaceOrder`: when integrating new orders \n\n`ApproveOrder`: when approving existing orders \n\n`Unknown`: when we’re not able to identify the flow" example: ApproveOrder success: type: boolean description: Boolean that indicates if the response is successful or not. example: true operationId: type: string nullable: true description: String GUID that identifies the operation in our service. This field can be used to help us analyze unexpected errors or behaviors. example: '1234567' errors: type: array nullable: true description: List with errors related to the response, if there's any. items: type: object title: errors required: - source - code - description properties: source: type: string title: Checkout description: "Includes the following fields pointing out the context of the error: \n\n`Fulfillment` \n\n`Checkout` \n\n`Order Integration`" example: Fulfillment code: type: string title: code description: 'String containing the code returned by the source. Example value: If the source is `Fulfillment`, the code can be FMT005 to indicate that the item(s) in the order are not available.' example: FMT005 description: type: string title: description description: String containing the error message/description returned by the source. example: Message describing the error. example: source: Fulfillment code: FMT005 description: Message describing the error. fields: type: object nullable: true description: "Structure with important fields for the connector. This structure is only returned if the response is successful. Includes the following fields: \n\n`mainOrderId`: String with the order's ID inside the main seller account in VTEX. \n\n`franchiseOrderId`: - String with the order's ID inside the franchise seller account in VTEX. Only returned if the order was integrated using the [Multilevel Omnichannel Inventory](https://help.vtex.com/en/tutorial/multilevel-omnichannel-inventory--7M1xyCZWUyCB7PcjNtOyw4) feature, that is: \n\n- `allowFranchises` field set to `true` when integrating the order \n\n- `SLA` chosen for the order is from a franchise account." properties: fields: type: object title: fields required: - mainOrderId properties: mainOrderId: type: string title: mainOrderId description: String with the order’s ID inside the main seller account in VTEX. example: MKP-123456789 franchiseOrderId: type: string title: franchiseOrderId description: "String with the order's ID inside the franchise seller account in VTEX. Only returned if the order was integrated using the [Multilevel Omnichannel Inventory](https://help.vtex.com/en/tutorial/multilevel-omnichannel-inventory--7M1xyCZWUyCB7PcjNtOyw4) feature, that is: \n\n- `allowFranchises` field set to `true` when integrating the order \r\n- SLA chosen for the order is from a franchise account" example: '432874921387409182347' example: mainOrderId: MKP-123456789 franchiseOrderId: '432874921387409182347' example: franchiseOrderId: '38475934875' message: type: string description: 'String with a message explaining the code returned in the response. ' example: The order was integrated into VTEX successfully example: marketplaceOrderId: null accountName: grocery1 code: SOI003 flow: PlaceOrder success: true operationId: null errors: null fields: null message: Order successfully enqueued CustomData: title: CustomData description: Structure with the order's customizable fields. To insert custom fields in the order, you must first go through the process of [Creating an app](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-app-template), and then adding the app, as well as the desired fields, within the seller's `orderForm`. More information on [Creating customizable fields in the cart with Checkout API](https://developers.vtex.com/vtex-rest-api/docs/customizable-fields-with-checkout-api). required: - customApps type: object properties: customApps: type: array items: $ref: '#/components/schemas/CustomApp' description: Array of objects with information about custom apps. example: customApps: - id: marketplace-integration major: 1 fields: marketplacePaymentMethod: credit card Item: title: Item required: - id - price - quantity type: object properties: id: type: string title: id description: String with the SKU ID in VTEX’s catalog. example: '1' price: type: integer title: price description: Integer with the SKU’s unit price. If the value is `USD110.50`, convert it to the format → `11050`. example: 11050 quantity: type: integer title: quantity description: Integer with the quantity of the SKU present in the order. The value should be greater than zero. example: 10 example: id: '1' price: 975 quantity: 1 partialUpdateConnector: title: Partial update connector required: - path - op - value type: object properties: path: type: string default: '' description: What part of the configuration do you want to change. op: type: string default: '' description: Type of operation to be performed. value: type: string default: '' description: New value which will appear in the changed field. example: path: /segment op: replace value: DEPARTMENT_STORES InvoiceData: title: InvoiceData description: Object with the order's billing data. required: - userPaymentInfo type: object properties: userPaymentInfo: $ref: '#/components/schemas/UserPaymentInfo' example: userPaymentInfo: paymentMethods: - creditCardPaymentGroup UpdateOrderStatusRequest: title: UpdateOrderStatusRequest required: - marketplaceOrderId - marketplaceOrderStatus - connectorName - connectorEndpoint type: object properties: marketplaceOrderId: type: string description: String that indicates the order's ID in the marketplace. example: 7e62fcd3-827b-400d-be8a-f050a79c4976 marketplaceOrderStatus: type: string title: marketplaceOrderStatus description: "Required field including a string with the order’s status in the marketplace. If you send an order with the status APPROVED to integrate, our service will automatically try to advance its status in VTEX after integrating it. This field accepts the following values: \n\n- `new` \n\n- `approved`." example: new connectorName: type: string title: connectorName description: "String with the identifier code of the connector responsible for the order. \n\nThis field is optional if the connector uses the [App Template](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-app-template) and authenticates on our request via `VtexIdclientAutCookie`. \n\nIt is required if the connector is native or does not use the App Template." example: connectorName connectorEndpoint: type: string title: connectorEndpoint description: "String with the connector's base endpoint that will receive notifications about the orders processing results, as well as status updates from VTEX OMS. This field does not accept query strings. You can use the models below: \n\n- `https://{{externalconnector}}.com` \n\n- `https://{{externalconnector.com}}/api/vtex` if you additionaly want to send a relative URL with the endpoint. \n\nThis field is optional if the connector uses the [App Template](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-app-template) and authenticates on our request via `VtexIdclientAutCookie`. \n\nIt is required if the connector is native or does not use the App Template." example: https://{{externalconnector.com}}/api/vtex example: marketplaceOrderId: '{{$guid}}' marketplaceOrderStatus: APPROVED connectorName: Skyhub connectorEndpoint: https://connector-endpoint.com/api/vtex Approveorder: title: Approveorder required: - marketplaceOrderId - accountName - code - flow - success - operationId - errors - fields - message type: object properties: marketplaceOrderId: type: string nullable: true description: String that indicates the order's ID in the marketplace. example: 7e62fcd3-827b-400d-be8a-f050a79c4976 accountName: type: string description: String that indicates which account made the request. example: accountName nullable: true code: type: string description: String with a internal Channel Order API code that classifies the response. The possible values returned in this field are described in the Response Codes section of this API Reference. example: SOI001 flow: type: string description: "String containing the name of the flow responsible for the response. This field can contain the following values: \n\n`PlaceOrder`: when integrating new orders. \n\n`ApproveOrder`: when approving existing orders. \n\n`Unknown`: when we’re not able to identify the flow." example: ApproveOrder success: type: boolean description: Boolean that indicates if the response is successful or not. example: true operationId: type: string nullable: true description: String GUID that identifies the operation in our service. This field can be used to help us analyze unexpected errors or behaviors. example: '1234567' errors: type: array nullable: true description: List with errors related to the response, if there is any. items: type: object title: errors required: - source - code - description properties: source: type: string title: Checkout description: "Includes the following fields pointing out the context of the error: \n\n`Fulfillment` \n\n`Checkout` \n\n`Order Integration`" example: Fulfillment code: type: string title: code description: 'String containing the code returned by the source. Example value: If the source is `Fulfillment`, the code can be FMT005 to indicate that the item(s) in the order are not available.' example: FMT005 description: type: string title: description description: String containing the error message/description returned by the source. example: Message describing the error. example: source: Fulfillment code: FMT005 description: Message describing the error. fields: type: object nullable: true description: "Structure with important fields for the connector. This structure is only returned if the response is successful. Includes the following fields: \n\n`mainOrderId`: String with the order's ID inside the main seller account in VTEX. \n\n`franchiseOrderId`: - String with the order's ID inside the franchise seller account in VTEX. Only returned if the order was integrated using the [Multilevel Omnichannel Inventory](https://help.vtex.com/en/tutorial/multilevel-omnichannel-inventory--7M1xyCZWUyCB7PcjNtOyw4) feature, that is: \n\n- `allowFranchises` field set to `true` when integrating the order \n\n- `SLA` chosen for the order is from a franchise account." properties: fields: type: object title: fields required: - mainOrderId properties: mainOrderId: type: string title: The mainOrderId Schema description: String with the order’s ID inside the main seller account in VTEX. example: MKP-123456789 franchiseOrderId: type: string title: The franchiseOrderId Schema description: "String with the order's ID inside the franchise seller account in VTEX. Only returned if the order was integrated using the [Multilevel Omnichannel Inventory](https://help.vtex.com/en/tutorial/multilevel-omnichannel-inventory--7M1xyCZWUyCB7PcjNtOyw4) feature, that is: \n\n- `allowFranchises` field set to `true` when integrating the order \r\n- SLA chosen for the order is from a franchise account" example: '432874921387409182347' example: mainOrderId: MKP-123456789 franchiseOrderId: '432874921387409182347' example: franchiseOrderId: '38475934875' message: type: string description: String with a message explaining the code returned in the response. example: The order was integrated into VTEX successfully example: marketplaceOrderId: 7e62fcd3-827b-400d-be8a-f050a79c4976 accountName: null code: SOI003 flow: ApproveOrder success: true operationId: null errors: null fields: null message: Order successfully enqueued CustomApp: title: CustomApp required: - id - major - fields type: object properties: id: type: string title: id description: App's ID. example: ID major: type: integer title: major description: Integer with the major version of the app. Optional, defaulting to one. example: 1 fields: $ref: '#/components/schemas/Fields' example: id: marketplace-integration major: 1 fields: marketplacePaymentMethod: credit card VtexMapperRegistration: required: - displayName - categoryTreeEndPoint - mappingEndPoint - properties type: object properties: displayName: type: string description: Marketplace Name, that will be displayed in VTEX Mapper. example: Marketplace A categoryTreeEndPoint: type: string description: Endpoint that returns categories and attributes according to VTEX Mapper specifications. example: http://api.vtexinternal.com.br/api/{{marketplaceName}}/mapper/categories mappingEndPoint: type: string description: Secure endpoint that will receive the category mapping sent by VTEX Mapper. example: http://api.vtexinternal.com.br/api/{{marketplaceName}}/mapper/mapping properties: required: - allowsRemap type: object description: Refers to the `allowsRemap` property. items: type: object properties: allowsRemap: type: boolean description: Allows rempaping categories in case the marketplace or seller tree is altered. If marked as `true`, all trees will be remapped. example: false CategoryTreeProcessingNotificationEndpoint: description: The `CategoryTreeProcessingNotificationEndpoint` is optional, and should be an endpoint from the external marketplace, that will be notified after the marketplace's category tree is successfully processed or not. type: string example: https://CategoryTreeProcessingNotificationEndpoint.com/api sendCategoryMappingToVtexMapper: required: - categories - id - name type: object properties: categories: required: - id - name - children type: array title: '' description: Array with Marketplace parent categories and their information. default: [] items: type: object title: '' properties: id: type: string title: id description: ID of the parent category in the marketplace. default: '1' name: type: string title: name description: Name of the parent category in the marketplace. default: Appliances children: type: array title: chidren description: Array with children categories in the marketplace, and their information. default: [] items: type: object required: - id - name - children - specifications properties: id: type: string title: id description: ID of the child category in the marketplace. default: 1a name: type: string title: name description: Name of the child category in the marketplace. default: Kitchen children: type: array title: children description: Grandchildren categories in the marketplace. Send as array of `ID`, `name` and `specifications`. default: [] items: {} nullable: true specifications: type: array title: specifications description: Specifications for the Product or SKU default: - attributeName: Color required: true attributeValues: - valueName: Red items: type: object description: Specifications of children categories. example: attributeName: Color required: true attributeValues: - valueName: Red required: - attributeName - required - attributeValues properties: attributeName: type: string title: attributeName description: Name of the attribute sent as a specification. default: Color required: type: boolean title: required description: If the specification is required, mark this flag as `true`. If not, mark it as `false`. default: false attributeValues: type: array title: attributeValues description: Values of the atttribute specified. default: - valueName: Red items: type: object title: valueName description: Array of the multiple `valueNames` for the attribute specificied. default: valueName: Red required: - valueName properties: valueName: type: string title: valueName description: Name of the value default: Red fullUpdateConnector: title: '' required: - name - website - logo - description - segment - availableCountries - connectorVtexAdminPath - connectorApiEndpoint type: object properties: name: type: string default: '' description: Connector's name. website: type: string default: '' description: Connector's website. logo: type: string default: '' description: Connector's logo. description: type: string default: '' description: Marketplace presentation description. segment: type: string default: '' description: Marketplace segment. availableCountries: type: array default: [] description: Countries where integration is available. items: type: string connectorVtexAdminPath: type: string default: '' title: Link to Admin VTEX page where the merchant can configure integration with connector. connectorApiEndpoint: type: string default: '' title: Connector's API Base URL example: name: Mercado Livre Classic website: mercadolivre.com.br logo: https://g.foolcdn.com/art/companylogos/square/meli.png description: MercadoLibre operates online commerce platforms in Latin America. It operates Mercado Libre Marketplace, an automated online commerce platform that enables businesses, merchants, and individuals to list merchandise and conduct sales and purchases online. segment: OTHERS availableCountries: - BRA - ARG connectorVtexAdminPath: /bridge/#/settings?openConfig=mercadolivre connectorApiEndpoint: portal.vtexcommercestable.com/api/meliintegration/notifications Deliverybyfranchiseseller: title: Deliverybyfranchiseseller required: - marketplaceOrderId - accountName - code - flow - success - operationId - errors - fields - message type: object properties: marketplaceOrderId: type: string nullable: true description: String that indicates the order's ID in the marketplace. example: 7e62fcd3-827b-400d-be8a-f050a79c4976 accountName: type: string description: String that indicates which account made the request. example: accountName code: type: string description: String with a internal Channel Order API code that classifies the response. The possible values returned in this field are described in the [Response Codes]() section. example: SOI001 flow: type: string description: "String containing the name of the flow responsible for the response. This field can contain the following values: \n\n`PlaceOrder`: when integrating new orders \n\n`ApproveOrder`: when approving existing orders \n\n`Unknown`: when we’re not able to identify the flow" example: ApproveOrder success: type: boolean description: Boolean that indicates if the response is successful or not. example: true operationId: type: string nullable: true description: String GUID that identifies the operation in our service. This field can be used to help us analyze unexpected errors or behaviors. example: '1234567' errors: type: array nullable: true description: List with errors related to the response, if there's any. items: type: object title: errors required: - source - code - description properties: source: type: string title: Checkout description: "Includes the following fields pointing out the context of the error: \n\n`Fulfillment` \n\n`Checkout` \n\n`Order Integration`" example: Fulfillment code: type: string title: code description: 'String containing the code returned by the source. Example value: If the source is `Fulfillment`, the code can be FMT005 to indicate that the item(s) in the order are not available.' example: FMT005 description: type: string title: description description: String containing the error message/description returned by the source. example: Message describing the error. example: source: Fulfillment code: FMT005 description: Message describing the error. fields: type: object nullable: true description: "Structure with important fields for the connector. This structure is only returned if the response is successful. Includes the following fields: \n\n`mainOrderId`: String with the order's ID inside the main seller account in VTEX. \n\n`franchiseOrderId`: - String with the order's ID inside the franchise seller account in VTEX. Only returned if the order was integrated using the [Multilevel Omnichannel Inventory](https://help.vtex.com/en/tutorial/multilevel-omnichannel-inventory--7M1xyCZWUyCB7PcjNtOyw4) feature, that is: \n\n- `allowFranchises` field set to `true` when integrating the order \n\n- `SLA` chosen for the order is from a franchise account." properties: fields: type: object title: fields required: - mainOrderId properties: mainOrderId: type: string title: mainOrderId description: String with the order’s ID inside the main seller account in VTEX. example: MKP-123456789 franchiseOrderId: type: string title: franchiseOrderId description: "String with the order's ID inside the franchise seller account in VTEX. Only returned if the order was integrated using the [Multilevel Omnichannel Inventory](https://help.vtex.com/en/tutorial/multilevel-omnichannel-inventory--7M1xyCZWUyCB7PcjNtOyw4) feature, that is: \n\n- `allowFranchises` field set to `true` when integrating the order \r\n- SLA chosen for the order is from a franchise account" example: '432874921387409182347' example: mainOrderId: MKP-123456789 franchiseOrderId: '432874921387409182347' example: franchiseOrderId: '38475934875' message: type: string description: 'String with a message explaining the code returned in the response. ' nullable: true example: The order was integrated into VTEX successfully example: marketplaceOrderId: null accountName: grocery1 code: SOI003 flow: PlaceOrder success: true operationId: null errors: null fields: null message: Order successfully enqueued GeoCoordinates: title: GeoCoordinates description: Structure with the address geocoordinates. Optional for `delivery` orders, required for `pickup-in-point` orders. required: - latitude - longitude type: object properties: latitude: type: string title: latitude description: "Double value with the latitude coordinates of the address. Required only if the geoCoordinates field is defined. \n\nExample format: `-25.4158764`." example: '-25.4158764' longitude: type: string title: longitude description: 'Double value with the longitude coordinates of the address. Required only if the geoCoordinates field is defined. Example format: `-49.342759`.' example: '-49.342759' DeliveryIds: title: DeliveryIds description: List of delivery IDs, used for orders where the marketplace is responsible for the fulfillment of the order, including keeping inventory at a warehouse as well as the delivery. required: - warehouseId type: object properties: warehouseId: type: string description: String with the ID of the warehouse used for marketplace fulfillment. Required when `isFob` = `true` and `isMarketplaceFulfillment` = `true`. example: AR1 example: warehouseId: AR1 EnqueueNewOrderRequest: title: EnqueueNewOrderRequest required: - marketplaceOrderId - marketplaceOrderStatus - marketplacePaymentValue - allowFranchises - items - clientProfileData - shippingData - invoiceData type: object properties: marketplaceOrderId: type: string title: marketplaceOrderId description: String that indicates the order's ID in the marketplace. example: 7e62fcd3-827b-400d-be8a-f050a79c4976 marketplaceOrderStatus: type: string title: marketplaceOrderStatus description: "Required field including a string with the order’s status in the marketplace. If you send an order with the status APPROVED to integrate, our service will automatically try to advance it’s status in VTEX after integrating it. This field accepts the following values: \n\n- `new` \n\n- `approved`" example: new marketplacePaymentValue: type: integer title: marketplacePaymentValue description: Integer that indicates the order’s total value, which the marketplace will pay to the seller. It’s important to note that this value should include interest, if that’s the case. If the value is `USD110.50`, convert it to the format → `11050`. example: 11050 connectorName: type: string title: connectorName description: "String with the identifier code of the connector responsible for the order. \n\nThis field is optional if the connector uses the [App Template](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-app-template) and authenticates on our request via `VtexIdclientAutCookie`. \n\nIt is required if the connector is native or does not use the App Template." example: connectorName connectorEndpoint: type: string title: connectorEndpoint description: "String with the connector's base endpoint that will receive notifications about the orders processing results, as well as status updates from VTEX OMS. This field accepts query strings. You can use the models below: \n\n- `https://{{externalconnector}}.com` \n\n- `https://{{externalconnector.com}}/api/vtex` if you additionaly want to send a relative URL with the endpoint. \n\nThis field is optional if the connector uses the [App Template](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-app-template) and authenticates on our request via `VtexIdclientAutCookie`. \n\nIt is required if the connector is native or does not use the App Template." example: https://{{externalconnector.com}}/api/vtex allowFranchises: type: boolean title: allowFranchises description: Boolean indicating whether franchise accounts linked to the main seller should be considered. That is, if the order delivery pickup/SLA can belong to a [franchise account](https://help.vtex.com/en/tutorial/what-is-a-franchise-account--kWQC6RkFSCUFGgY5gSjdl), for example. This field is optional and defaults to `false`. example: false pickupAccountName: type: string title: pickupAccountName description: String that indicates the name of the account responsible for the order’s pickup point. It is only required for pickup-in-point orders from franchise accounts, when franchise accounts `allowFranchises` is `true` and the order in question has a `pickup-in-point` delivery type. It is optional otherwise. example: accountName items: type: array items: $ref: '#/components/schemas/Item' clientProfileData: $ref: '#/components/schemas/ClientProfileData' shippingData: $ref: '#/components/schemas/ShippingData' invoiceData: $ref: '#/components/schemas/InvoiceData' customData: $ref: '#/components/schemas/CustomData' example: marketplaceOrderId: '{{$guid}}' marketplaceOrderStatus: NEW marketplacePaymentValue: 3025 connectorName: SkyHub connectorEndpoint: https://connector-endpoint.com/api/vtex allowFranchises: false pickupAccountName: '' items: - id: '1' price: 975 quantity: 1 clientProfileData: email: email@email.com.br firstName: John lastName: Doe phone: '99999999999' document: '99999999999' corporateDocument: null corporatePhone: null corporateName: null tradeName: null stateInscription: null shippingData: logisticsInfo: - price: 2050 selectedDeliveryChannel: delivery selectedSla: Express lockTTL: 1d shippingEstimate: 2d deliveryIds: warehouseId: AR1 selectedAddresses: - addressType: Residential addressId: '1' receiverName: John Doe postalCode: 81020-235 city: Curitiba state: PR country: BRA street: Rua Eduardo Carlos Pereira number: '4125' neighborhood: Portão complement: '101' geoCoordinates: latitude: '-29.5' longitude: '-45.8' isFob: true isMarketplaceFulfillment: true invoiceData: userPaymentInfo: paymentMethods: - creditCardPaymentGroup customData: customApps: - id: marketplace-integration major: 1 fields: marketplacePaymentMethod: credit card SelectedAddress: title: SelectedAddress description: List with the delivery addresses selected for the order. We currently only support a single delivery address. required: - addressType - addressId - receiverName - postalCode - country type: object properties: addressType: type: string title: addressType description: 'String with the address type. The field supports the values: `residential`, `commercial`, `pickup`.' example: commercial addressId: type: string title: addressId description: String with the address identifier. Optional for `delivery` type orders, and required for `pickup-in-point` orders. example: '1' receiverName: type: string title: receiverName description: String with the name of the person responsible for receiving the order. example: Yennefer of Vengerberg postalCode: type: string title: postalCode description: String with the address' postal code. example: 81020-235 city: type: string title: city description: String with the city’s name. example: City state: type: string title: state description: String with the state's name, filled in with two letter code. example: RJ country: type: string title: country description: String with the state's name, filled in with three letter code. example: BRA street: type: string title: street description: String with the street's name. example: The Witcher Avenue number: type: string title: The number description: String with the street's number. example: '1986' neighborhood: type: string title: The neighborhood schema description: String with the neighborhood's name. example: Neighborhood's name complement: type: string title: complement description: String with the address' complement, like building name, or extra number. example: Complement to address geoCoordinates: $ref: '#/components/schemas/GeoCoordinates' LogisticsInfo: title: LogisticsInfo description: "List that references the SLAs responsible for delivering each item in the order. \n\nThis list must contain the same number of items as the `items` list, previously defined. For example: if the order contains 3 SKUs, you must describe 3 SLAs in this list, one for each SKU (even in cases where the same SLA will deliver all of them). \n\nThe order of the SLAs in this list must also follow the same order as in the `items` list. For example: if the SLA named **Correios Express** will be responsible for delivering the SKU with ID equal to **1015**, which is found at index 0 of the `items` list, it must be in index 0 of the `logisticsInfo` list as well." required: - price - selectedDeliveryChannel - selectedSla - lockTTL - shippingEstimate - deliveryIds type: object properties: price: type: integer title: price description: Integer indicating the shipping price for this SKU. If the value is `USD20.50`, convert it to the format → `2050`. example: 2050 selectedDeliveryChannel: type: string title: selectedDeliveryChannel description: "String with the selected delivery channel. This field supports the following values: \n\n- `delivery`, \n\n- `pickup-in-point`." example: delivery selectedSla: type: string title: selectedSla description: String with the selected delivery SLA. example: T-G1-2-Express lockTTL: type: string title: lockTTL description: "String with the inventory reservation period in VTEX's logistics system. To fill in this field insert the number of days, followed by the letter for the chosen unit. \n\n- Days: `d` \n\n- Business days: `bd`. \n\nExample formats: `12d`, `5d`." example: 5d shippingEstimate: type: string title: shippingEstimate description: "String with the order's estimated delivery time. To fill in this field, insert a number, followed by the letter for the chosen unit. \n\n- Days: `d` \n\n- Business days: `bd`. \n\n- Hours: `h` \n\n- Minutes: `m`. \n\nExample formats: `12d`, `5bd`, `3h`, `50m`." example: 7d deliveryIds: $ref: '#/components/schemas/DeliveryIds' example: price: 2050 selectedDeliveryChannel: delivery selectedSla: Express lockTTL: 1d shippingEstimate: 2d deliveryIds: warehouseId: AR1 UserPaymentInfo: title: UserPaymentInfo description: Structure with the order’s payment data. Required only if `invoiceData` is defined. required: - paymentMethods type: object properties: paymentMethods: type: array items: type: string description: List of strings with the payment methods used in the order. Required only if `invoiceData` is defined. The format and some possible values of payment methods accepted in this list can be found in the call [Fetching marketplace information with the Orders API](https://developers.vtex.com/vtex-rest-api/docs/get-marketplace-data-orders-api). example: - creditCardPaymentGroup example: paymentMethods: - creditCardPaymentGroup ClientProfileData: title: ClientProfileData description: Structure with the customer's information. An order will be identified as corporate if any of the corporate fields are filled out (`corporateDocument`, `corporatePhone`, `corporateName` or `tradeName`). required: - email - firstName - lastName - phone - document - corporateDocument - corporatePhone - corporateName - tradeName - stateInscription type: object properties: email: type: string title: email description: String with the customer's email. example: cirilla@cintra.com firstName: type: string title: firstName description: String with the customer's first name. example: Cirilla lastName: type: string title: lastName description: String with the customer’s surname. example: Cintra phone: type: string title: phone description: String with the customer’s phone number. example: '99999999999' document: type: string title: The document schema description: String with the customer’s document number. example: '99999999999' corporateDocument: type: string title: corporateDocument description: String with the company’s document number, in case of corporate orders. nullable: true example: '99999999999' corporatePhone: type: string title: corporatePhone description: String with the company’s phone number, in case of corporate orders. nullable: true example: '99999999999' corporateName: type: string title: corporateName description: String with the company’s name, in case of corporate orders. nullable: true example: The Witcher Inc. tradeName: type: string title: tradeName description: String with the company’s fantasy name, in case of corporate orders. nullable: true example: The Witcher stateInscription: type: string title: stateInscription description: String with the company’s state registration, in case of corporate orders. nullable: true example: '99999999999' ShippingData: title: ShippingData required: - logisticsInfo - selectedAddresses - isFob - isMarketplaceFulfillment type: object properties: logisticsInfo: type: array items: $ref: '#/components/schemas/LogisticsInfo' description: "List that references the SLAs responsible for delivering each item in the order. \n\nThis list must contain the same number of items as the `items` list, previously defined. For example: if the order contains 3 SKUs, you must describe 3 SLAs in this list, one for each SKU (even in cases where the same SLA will deliver all of them). \n\nThe order of the SLAs in this list must also follow the same order as in the `items` list. For example: if the SLA named **Correios Express** will be responsible for delivering the SKU with ID equal to **1015**, which is found at index 0 of the `items` list, it must be in index 0 of the `logisticsInfo` list as well." selectedAddresses: type: array items: $ref: '#/components/schemas/SelectedAddress' description: '' isFob: type: boolean title: isFob description: Boolean that indicates whether the order's delivery is the marketplace responsibility. Optional, defaulting to false. example: false isMarketplaceFulfillment: type: boolean title: isMarketplaceFulfillment description: Boolean that indicates whether the order's inventory in warehouse is the marketplace's responsibility. Optional, defaulting to false. example: false securitySchemes: VtexIdclientAutCookie: type: apiKey in: header name: VtexIdclientAutCookie description: '[User token](https://developers.vtex.com/docs/guides/api-authentication-using-user-tokens), valid for 24 hours.'