ORDERS

Order import

Shopee Brazil orders are imported into Base and mirrored into Odoo as sales orders, with buyer data, line items, shipping data and marketplace status information. Order processing stays in Base, the financial trail stays in Odoo.

Triggered on order creation / marketplace sync

INVOICING

Invoice / NF / XML forwarding

Base can forward invoice data/XML to Shopee Brazil according to the marketplace flow. This helps keep fiscal and fulfillment processes aligned.
Note: if shipment is already created in Shopee, manual upload may be required.

Brazil fiscal flow supported

SYNC ENGINE

Stock sync

Odoo stock can be used as the source for Base, and Base sends the quantity to Shopee on the chosen interval. Multiple warehouse sources can be configured in Base.

Intervals: off · 8 h · 3 h · 1 h · 5 min · near real-time depending on plan

SYNC ENGINE

Price sync

Odoo prices can drive Shopee offer prices through Base price groups. Price multipliers, fixed additions and rounding rules can be configured in Base.

Intervals: off · 24 h · 12 h · 4 h · 1 h · near real-time depending on plan

CATALOG

Listing management + bulk updates

Create, edit, import and manage Shopee offers from Base. Listings are connected to products from the Base catalog/warehouse, which allows stock and price synchronization to work correctly. Bulk operations available for selected offer data such as name, description and images.

Bulk actions available

CATALOG

Category and attribute mapping

Base supports favorite categories and parameter mapping rules for Shopee. Attribute values must match Shopee dictionaries, otherwise the marketplace may reject the listing or update. Configured per Shopee account in Base.

Configured per Shopee account

AFTER-SALE

Return processing

Shopee returns can be imported into Base. Return status mapping can be configured so the after-sale flow remains visible in Base and connected to the related order.

Status mapping configured in Base

AFTER-SALE

Cancellation handling

Base can react to Shopee cancellation requests and import cancellation information. Sending cancellation statuses back to Shopee is limited by the Shopee API – only selected cancellation reasons are supported.

API-supported reasons only

LOGISTICS

Shipping + courier data

Base can forward tracking numbers to Shopee and map Shopee delivery channels to Base courier integrations. Courier mapping is configured in Base advanced settings.

Tracking forwarding supported

LOGISTICS

Labels and Shopee Full

For Shopee Full/Fulfillment, labels may need to be generated in Shopee Seller Center rather than fully handled in Base. Base can still be used for order import, reporting and operational control.

Shopee Full: labels via Seller Center

BRAZIL ONLY

Brazilian fiscal flow

Base supports Shopee Brazil fiscal requirements around invoice/XML forwarding and marketplace validation. Fiscal data must be correct before shipment steps are completed.

NF/XML forwarding supported

ARCHITECTURE

Multi-company

Several Odoo companies can be connected through Base, provided the account, product, stock and mapping setup is separated correctly. Each company can use its own API key and mapping.

Per-company API key + mapping

• Shopee integration is documented for Shopee Brazil / shopee.com.br. Do not assume support for other Shopee countries without separate verification.
• Shopee does not accept HTML in offer descriptions. Descriptions are limited to 3000 characters.
• Shopee variants support a maximum of 2 variation levels. More complex Odoo variant structures may need to be simplified before listing.
• Stock and price synchronization require correct offer-to-product association in Base. If an offer is not linked to a product, synchronization will not work.
• Shopee may block price or stock updates while an offer is in a promotion.
• Only limited cancellation statuses can be sent to Shopee via API.
• Shopee Full/Fulfillment labels may need to be handled directly in Shopee Seller Center.
• If shipment is already created, Shopee may reject XML sent through API – manual upload may be required.
• Shopee token expiry may require manual reconnection in Base.
• Category and parameter mappings are configured per Shopee account and should not be assumed to copy between accounts.

FROM ODOO TO BASE

Master data, outbound

• Products and variants
• Stock on-hand – at chosen interval
• Price lists / price groups – at chosen interval
• Fiscal data required for the Brazilian flow

FROM BASE TO ODOO

Operational results, inbound

• Sales orders
• Buyer and order line data
• Shipping data
• Invoice/fiscal process results where configured

1

Install the Base Connector module in Odoo

Install from the Odoo App Store on your 17.0 instance (Community or Enterprise). Enable External API in Odoo settings and make sure the Inventory module is installed.

Where: Odoo

2

Generate an Odoo API key from this module

Open the Base Connector module in Odoo, generate the API key, then copy the key together with your database name and the technical user it was issued for.

Where: Odoo

3

Paste credentials into Base.com and connect Shopee Brazil

In Base, add the Odoo API key, database name and user. Then connect your Shopee Brazil seller account using the Shopee authorization flow.

Where: Base.com

4

Configure sync rules and go live

Choose stock sync interval, price sync interval, product source, price group, stock source, courier mapping, return mapping and invoice/XML flow. Then enable the integration.

Where: Base.com · Status: Live

BASE DOES THIS FOR YOU

What Base handles, so Odoo stays clean

Once the API key is in place, none of the items below need any further setup in Odoo.

• Shopee Brazil order centralization
• Offer creation and management
• Stock synchronization
• Price synchronization
• Tracking number forwarding
• Invoice/XML forwarding to Shopee
• Return import and return status mapping
• Cancellation request handling
• Courier and delivery channel mapping
• Category and attribute mapping
• Brazil-specific fiscal flow support

What your Odoo needs

• Odoo 17.0 (Community or Enterprise)
  Earlier versions not supported in this release
• External API enabled
  Settings → Developer mode → Enable API access
• API key from this module
  Issued by this module, scoped to one user
• Database name + technical user
  Used by Base.com to authenticate
• Inventory module installed
  Required for stock sync
• Company alignment
  One Odoo company per Base seller account
• Reachable domain
  Odoo.sh customers: use your .sh subdomain

What your Base account needs

• Active Base.com subscription
  With access to marketplace integrations
• Shopee Brazil seller account
  shopee.com.br
• Shopee API authorization
  Granted from Base during connection
• Base Sales module enabled
  Required for order centralization
• Sync intervals configured
  Stock and price rules selected in Base
• Courier mapping
  Shopee delivery channels mapped to Base couriers where needed
• Invoice/XML flow configured
  Required for Shopee Brazil fiscal handling

External service notice. Base Connector relies on Base.com to operate. The Odoo module by itself only issues the API key and exposes data through the Odoo External API – the Shopee integration logic runs on Base.com infrastructure. An active Base.com subscription and connected Shopee Brazil seller account are required for the connector to function. Without them, no syncing occurs and no marketplace operations are handled. base.com · Privacy Policy

Do I need a Base.com account to use this module?

Yes. The Odoo module on its own only generates an API key – it does not connect to Shopee directly. The actual integration runs on Base.com, so an active Base subscription with a connected Shopee Brazil seller account is required.

Does this cover all Shopee countries?

No. The documented Base integration is for Shopee Brazil / shopee.com.br. Do not assume support for other Shopee markets without separate verification.

Are Shopee orders created as sales orders in Odoo?

Yes. Shopee orders are imported into Base and mirrored into Odoo as sales orders with buyer data, order lines and shipping information.

Is the stock sync close to real time?

Stock sync can be configured in Base, with intervals down to 5 minutes or near real-time depending on subscription and setup.

Where do I configure the Shopee side?

In Base.com. After you paste the Odoo API key into Base, Shopee settings such as listing rules, stock sync, price sync, courier mapping, return mapping and invoice/XML flow are configured in the Base interface. Odoo does not need to be touched again.

Does this support Brazilian invoice/XML flow?

Yes. Base supports forwarding invoice/XML data to Shopee Brazil. The flow must be configured correctly, and Shopee may reject XML if the shipment has already been created.

Can I use HTML descriptions?

No. Shopee does not accept HTML in descriptions. Descriptions are also limited to 3000 characters.

Does it support variants?

Yes, but Shopee supports a maximum of 2 variation levels. More complex Odoo variant structures may need to be simplified before listing.

Does it work with multi-company setups?

Yes. Several Odoo companies can be connected through Base, provided the account, product, stock and mapping setup is separated correctly. Each company can use its own API key and mapping.