Sellers who sell their products on VTEX marketplaces now have access to the intermediary identification and payment method information for sales completed on that type of marketplace. VTEX clients operating as marketplaces will also send this information to their sellers (VTEX and non-VTEX).
You can now access the intermediary and payment method information using the “Get order” request in the Orders API.
Why did we make this change?
Information contained in ecommerce invoices may vary depending on the laws of each country. For example, you may need to identify the intermediary and include the payment method for sales completed through a marketplace.
Legal requirements, like NT 2020.006 in Brazil, for issuing intermediary sales invoices prompted us to make this improvement to help our clients meet these obligations. Since this information is not personal data protected by laws around the world, this change has been applied to all VTEX stores without any exception.
What needs to be done?
If your store is subject to legal requirements as the ones mentioned above and it operates as a seller to other VTEX stores, any integrations that are used to issue invoices can be updated to include this information.
To identify the intermediary (natively integrated marketplaces listed above), use the affiliateId
field.
To identify the payment method used, check this guide on how to retrieve marketplace sales data with the Orders API.