Manual do usuário
Central de ajuda/Manual do usuário/Diretório de conectores: ERP, WMS externos e plataformas operacionais

Diretório de conectores: ERP, WMS externos e plataformas operacionais

Última atualização 2026-10-20

ERP, WMS externos, frotas/telemática, rastreamento de contêineres e última milha: os campos exatos de cada assistente e onde obtê-los.

ERP e sistemas contábeis#

Os conectores ERP sincronizam as mesmas famílias de documentos nos dois sentidos: clientes, itens e pedidos entre o Docklify e o ERP, e faturas geradas de envios e recebimentos lançadas no ERP. Cada conector abaixo lista os campos exatos que seu assistente de conexão pede e onde obtê-los. Dica: se o seu ERP oferece um sandbox ou empresa de teste, crie a conexão lá primeiro para conferir os campos e fluxos, e depois passe para a empresa real.

QuickBooks Online

O QuickBooks Online é a plataforma de contabilidade em nuvem da Intuit para pequenas e médias empresas. Ele sincroniza o conjunto padrão de documentos ERP (clientes, itens e pedidos nos dois sentidos, e faturas lançadas de volta) pela API oficial do QuickBooks. Método de conexão: OAuth2 — cole um Access Token do seu app QuickBooks junto com o Realm ID da empresa.

CampoObrigatório?Onde obter
Realm ID (Company ID)ObrigatórioQuickBooks → engrenagem → Conta e configurações → Faturamento e assinaturas → Company ID
Access TokenObrigatórioObtido no portal Intuit Developer (OAuth2 playground); expira em 1 hora e é renovado com o Client ID / Secret do app
AmbienteOpcionalproduction (padrão) ou sandbox

Xero

O Xero é uma plataforma de contabilidade em nuvem para pequenas empresas e seus contadores. Ele sincroniza o conjunto padrão de documentos ERP pela API oficial do Xero. Método de conexão: OAuth2 — cole um Access Token do seu app Xero junto com o Tenant ID da organização a sincronizar.

CampoObrigatório?Onde obter
Tenant IDObrigatórioRetornado por GET api.xero.com/connections após OAuth, ou visível no seu app em developer.xero.com
Access TokenObrigatórioToken OAuth2 do seu app Xero; os escopos devem incluir accounting.transactions.read, accounting.contacts.read, accounting.settings.read

Odoo

O Odoo é um ERP modular de código aberto (vendas, estoque, contabilidade e mais), no Odoo Online ou no seu próprio servidor. Ele sincroniza o conjunto padrão de documentos ERP pela API externa do Odoo. Método de conexão: a Base URL e o banco de dados da sua instância, com login por usuário e uma API Key que o Odoo trata como senha.

CampoObrigatório?Onde obter
Base URLObrigatórioO endereço do seu Odoo, ex. https://mycompany.odoo.com
Banco de dadosObrigatórioO nome do banco de dados; no Odoo Online geralmente é o subdomínio
UsuárioObrigatórioO usuário do Odoo dono da API key
API KeyObrigatórioAvatar → My Profile → Account Security → New API Key; usada como senha

Nota: no Odoo Online, o acesso API externo exige o plano Custom.

NetSuite

O NetSuite é o ERP em nuvem da Oracle para operações maiores e multientidade. Ele sincroniza o conjunto padrão de documentos ERP pelos serviços web REST do NetSuite. Método de conexão: OAuth2 — seu Account ID e um Access Token de um registro de integração do NetSuite (a autenticação por tokens TBA não é compatível).

CampoObrigatório?Onde obter
Account IDObrigatórioNetSuite → Setup → Company → Company Information (sandbox: 1234567_SB1)
Access TokenObrigatórioUm token OAuth2 de um registro de integração do NetSuite com o escopo rest_webservices. TBA não é compatível: use OAuth2

Microsoft Dynamics 365 Business Central

O Microsoft Dynamics 365 Business Central é o ERP em nuvem da Microsoft para pequenas e médias empresas. Ele sincroniza o conjunto padrão de documentos ERP pela API do Business Central. Método de conexão: um registro de aplicativo no Microsoft Entra — Tenant ID, Client ID e Client Secret (login com credenciais de cliente).

CampoObrigatório?Onde obter
Tenant IDObrigatórioMicrosoft Entra → Registros de aplicativos → seu app → ID de diretório (tenant)
Client IDObrigatórioA mesma página de registro (Application ID)
Client SecretObrigatórioEntra → Certificados e segredos; exibido uma vez. No Business Central, crie também o registro do app Entra e seu conjunto de permissões
AmbienteOpcionalGeralmente “production”
EmpresaOpcionalNome da empresa no Business Central; vazio = a primeira

Sage Intacct

O Sage Intacct é uma plataforma de gestão financeira em nuvem para empresas multientidade e orientadas a finanças. Ele sincroniza o conjunto padrão de documentos ERP pela API REST do Intacct. Método de conexão: o Client ID / Client Secret do seu app no portal de desenvolvedores da Sage; empresas multientidade indicam também a entidade de lançamento.

CampoObrigatório?Onde obter
Client IDObrigatórioPortal do desenvolvedor Sage → seu app (credenciais REST)
Client SecretObrigatórioA mesma página do app
Entity IDOpcionalSó para empresas multientidade: a entidade destino

Use um usuário de integração dedicado no Intacct. Entrar na web com esse usuário invalida o token REST (erro REST-2102): reemita o token e não entre com ele.

Acumatica

O Acumatica é um ERP em nuvem para empresas médias de distribuição, manufatura e comércio. Ele sincroniza o conjunto padrão de documentos ERP pela API REST baseada em contratos do Acumatica. Método de conexão: entre no seu site e empresa do Acumatica com um usuário / senha com acesso API.

CampoObrigatório?Onde obter
Base URLObrigatórioO endereço do seu site Acumatica sem /entity, ex. https://erp.example.com/AcumaticaERP
EmpresaObrigatórioA empresa (tenant) do Acumatica
UsuárioObrigatórioUm usuário do Acumatica com acesso API
SenhaObrigatórioA senha desse usuário
FilialOpcionalA filial destino, se sua empresa usa filiais
Nome / versão do endpointOpcionalNome normalmente “Default” e uma versão compatível com seu Acumatica, ex. 24.200.001

Microsoft Dynamics 365 Finance & Supply Chain

O Microsoft Dynamics 365 Finance & Supply Chain Management é o ERP empresarial da Microsoft. Ele sincroniza o conjunto padrão de documentos ERP pelos serviços OData do ambiente. Método de conexão: um registro de aplicativo no Microsoft Entra — Tenant ID, Client ID e Client Secret — apontando para a URL do seu ambiente.

CampoObrigatório?Onde obter
URL do ambienteObrigatórioO endereço do seu ambiente F&SCM sem /data
Tenant IDObrigatórioMicrosoft Entra → Registros de aplicativos → ID de diretório
Client IDObrigatórioO mesmo registro. Registre-o também no F&O: Administração do sistema → Aplicativos Microsoft Entra ID, vinculado a um usuário / função
Client SecretObrigatórioEntra → Certificados e segredos; exibido uma vez

SAP S/4HANA

Sincroniza pelas APIs OData do S/4HANA. Não há endereço padrão (Cloud e local diferem) e há duas autenticações: o par Basic (usuário / senha) ou o trio OAuth2 (client ID / secret / token URL), não ambos.

CampoObrigatório?Onde obter
Base URLObrigatórioO endereço do seu host S/4HANA (equipe basis / destino BTP)
Cliente SAPOpcionalO número do cliente SAP, se o sistema usa vários
Usuário / senha (Basic)OpcionalUm usuário de comunicação no S/4HANA: este par OU o trio OAuth2
Client ID / Secret / Token URL (OAuth2)OpcionalSistemas Cloud: da service key do BTP da sua instância de integração

SAP Business One

O SAP Business One é o ERP da SAP para pequenas e médias empresas. Ele sincroniza o conjunto padrão de documentos ERP pelo Service Layer do Business One. Método de conexão: entre com o banco de dados da empresa, usuário e senha de um usuário do Business One com acesso API.

CampoObrigatório?Onde obter
URL do Service LayerObrigatórioO endereço do Service Layer sem /b1s/v2
Banco de dados da empresaObrigatórioO nome do banco de dados, ex. SBODemoUS
UsuárioObrigatórioUm usuário do Business One com acesso API
SenhaObrigatórioA senha desse usuário

Oracle Fusion ERP (Cloud)

Sincroniza pela REST API do Fusion. Preencha o par Basic (usuário / senha) ou um token OAuth obtido antes; o token tem prioridade.

CampoObrigatório?Onde obter
Base URLObrigatórioO endereço do seu ambiente Fusion
Usuário / senha (Basic)OpcionalUm usuário Fusion com funções de integração, ou o token abaixo
OAuth TokenOpcionalUm token Bearer obtido do seu domínio de identidade OCI / IDCS
Versão da APIOpcionalPadrão 11.13.18.05; altere só se o seu Fusion usa outra

Cin7

O Cin7 é uma plataforma em nuvem de estoque e gestão de pedidos para empresas de produtos multicanal. Ele sincroniza o conjunto padrão de documentos ERP pela API do Cin7. Método de conexão: o par API Username / API Password definido em uma conexão API dentro da sua conta Cin7.

CampoObrigatório?Onde obter
Usuário APIObrigatórioCin7 → go.cin7.com → Conexões API → o usuário da sua conexão
Senha APIObrigatórioDefinida na mesma conexão API

Epicor Kinetic

O Epicor Kinetic é um ERP feito para fabricantes e distribuidores. Ele sincroniza o conjunto padrão de documentos ERP pelos serviços REST do Kinetic. Método de conexão: usuário / senha, mais uma API Key criada no API Key Maintenance do Kinetic, com escopo de acesso cobrindo os serviços de pedidos, clientes e produtos.

CampoObrigatório?Onde obter
Base URLObrigatórioO endereço do seu servidor Kinetic sem /api
EmpresaObrigatórioO código da empresa, ex. EPIC06
UsuárioObrigatórioUm usuário do Kinetic para a integração
SenhaObrigatórioA senha desse usuário
API KeyObrigatórioKinetic → API Key Maintenance → New Key (exibida uma vez). O Access Scope deve cobrir SalesOrderSvc, CustomerSvc e PartSvc

Fishbowl

O Fishbowl é um sistema de gestão de estoque muito usado por empresas de produtos que usam o QuickBooks na contabilidade. Ele sincroniza o conjunto padrão de documentos ERP pela API do servidor Fishbowl. Método de conexão: usuário / senha sob um App Name; após o primeiro login, aprove esse app uma vez no Fishbowl, em Settings → Integrated Apps.

CampoObrigatório?Onde obter
URL do servidorObrigatórioO endereço do seu servidor Fishbowl, ex. http://192.168.1.10:80; precisa ser acessível pela internet ou VPN
UsuárioObrigatórioUm usuário do Fishbowl para a integração
SenhaObrigatórioA senha desse usuário
Nome do appObrigatórioO nome com que esta integração entra. Após o primeiro login, aprove no Fishbowl: Settings → Integrated Apps
App IDOpcionalAtribuído em Integrated Apps após a aprovação, se sua configuração usa

Brightpearl

O Brightpearl é uma plataforma de operações de varejo (pedidos, estoque e contabilidade) para vendedores multicanal. Ele sincroniza o conjunto padrão de documentos ERP pela API do Brightpearl. Método de conexão: OAuth — um Access Token obtido para o seu app via Authorization Code Grant, junto com Account, Datacenter, App Ref e Dev Ref.

CampoObrigatório?Onde obter
Conta (subdomínio)ObrigatórioO subdomínio do seu endereço Brightpearl, ex. “acme” em acme.brightpearl.com
DatacenterObrigatórioO api_domain retornado pelo fluxo OAuth, ex. use1.brightpearlconnect.com
App RefObrigatórioA referência do seu app na configuração de desenvolvedor do Brightpearl
Dev RefObrigatórioSua referência de desenvolvedor na mesma configuração
Access TokenObrigatórioObtido via Authorization Code Grant do seu app

WMS externos#

As conexões WMS externas funcionam ao contrário dos canais de venda: o Docklify (OMS / torre de controle) envia pedidos e ASNs a um sistema de armazém que não é o Docklify WMS e recebe estoque e confirmações de envio.

Item WMS (UNIS)

Conecta o Docklify a um armazém Item WMS / UNIS: descem pedidos e ASNs, sobem estoque e status de envio. Todos os IDs são atribuídos pela UNIS.

CampoObrigatório?Onde obter
UsuárioObrigatórioSeu usuário do Item WMS
SenhaObrigatórioSua senha do Item WMS
Company IDObrigatórioAtribuído pelo administrador da UNIS; vai em quase todas as chamadas
Customer IDObrigatórioAtribuído pelo financeiro da UNIS
Facility IDObrigatórioO ID de armazém atribuído pelo seu CSR da ITEM
Base URLOpcionalPadrão: endpoint de produção https://wms.item.com/api/public/v1/public

Logiwa

Conecta o Docklify a um armazém Logiwa: descem pedidos, sobem estoque e confirmações. A autenticação é o e-mail / senha da conta Logiwa, trocados por um token de sessão automaticamente.

CampoObrigatório?Onde obter
Usuário (e-mail)ObrigatórioO e-mail de um usuário Logiwa com acesso API
SenhaObrigatórioA senha desse usuário

Oracle WMS Cloud

Conecta o Docklify ao Oracle WMS Cloud (LogFire): descem pedidos, sobem estoque e confirmações. A autenticação vai pelo seu domínio IDCS da Oracle com um trio OAuth2; os valores exatos vêm da configuração da sua instância.

CampoObrigatório?Onde obter
Client IDObrigatórioO aplicativo confidencial IDCS da sua instância WMS
Client SecretObrigatórioO mesmo aplicativo IDCS
Token URLObrigatórioO endpoint de token OAuth do seu domínio IDCS

Frotas, telemática e mapas (TMS)#

Samsara

Traz dados de frota, veículos e motoristas (localizações, estatísticas) da Samsara ao TMS para despacho e rastreamento ao vivo.

CampoObrigatório?Onde obter
API TokenObrigatórioSamsara Dashboard → Settings → API Tokens: gere um token com leitura de fleet / vehicles / stats
Base URLOpcionalRegião API: padrão https://api.samsara.com; UE: https://api.eu.samsara.com

Motive

Traz dados de frota e veículos da Motive (KeepTruckin) ao TMS. A Motive usa OAuth 2.0 (authorization code): conclua primeiro a autorização e cole aqui o access token obtido.

CampoObrigatório?Onde obter
Access TokenObrigatórioO token obtido via gomotive.com/oauth/authorize → gomotive.com/oauth/token
Base URLOpcionalPadrão https://api.gomotive.com; altere só para um endpoint regional

FedEx Freight

Cotação LTL e reservas com a FedEx Freight pelo TMS, com o mesmo modelo de app do FedEx Developer Portal, mas com seu número de conta Freight.

CampoObrigatório?Onde obter
Client IDObrigatórioFedEx Developer Portal → seu app → Client ID
Client SecretObrigatórioA mesma página do app
Número de conta FreightObrigatórioSeu número de conta FedEx Freight (cotação LTL e faturamento)
Modo de testeOpcional"true" (padrão) usa o sandbox com credenciais de teste; "false" usa produção

Google Maps (Routes)

Cálculo de rotas e distâncias para o planejamento TMS / LastMile, via Routes API do Google.

CampoObrigatório?Onde obter
API KeyObrigatórioGoogle Cloud Console → crie um projeto → ative a Routes API → crie uma chave API (restrinja à Routes API e seus IPs)

Mapbox

Cálculo de rotas e distâncias para TMS / LastMile via Directions API da Mapbox; alternativa ao Google Maps: conecte um dos dois.

CampoObrigatório?Onde obter
Access TokenObrigatórioaccount.mapbox.com → Access Tokens

Rastreamento de contêineres (Drayage)#

Terminal49

Marcos de contêineres, horários de navios e disponibilidade em terminal para o Drayage, da Terminal49. A chave é de autosserviço e a Developer Key gratuita já rastreia até 100 contêineres.

CampoObrigatório?Onde obter
API KeyObrigatórioapp.terminal49.com/developers/api-keys: crie uma chave lá

Vizion

Eventos e marcos de rastreamento de contêineres para o Drayage, da Vizion. Não há cadastro de autosserviço: as chaves são emitidas pelo comercial da Vizion.

CampoObrigatório?Onde obter
API KeyObrigatórioEmitida pelo comercial da Vizion ao abrir a conta (cabeçalho X-API-Key)

Plataformas de última milha#

Estas duas conexões permitem ao LastMile despachar pedidos para redes de entrega sob demanda. Ambas pedem seu endereço de coleta na própria conexão, porque cada entrega é criada a partir desse ponto.

DoorDash Drive

O DoorDash Drive é a rede de entregas sob demanda da DoorDash para os seus próprios pedidos: o LastMile cria as entregas a partir do seu ponto de coleta e as acompanha até a porta do cliente. Método de conexão: credenciais API do portal de desenvolvedores da DoorDash — as solicitações são assinadas como JWT com seu Developer ID, Key ID e Signing Secret.

CampoObrigatório?Onde obter
Developer IDObrigatórioPortal do desenvolvedor DoorDash → página Credentials
Key IDObrigatórioA mesma página Credentials (par do signing secret)
Signing SecretObrigatórioA mesma página Credentials (base64; assina o JWT)
Endereço de coletaOpcionalEndereço de coleta em uma linha. Obrigatório, salvo se preencher External Business ID + External Store ID (vale o endereço da loja registrada)
External Business ID / External Store IDOpcionalSe seu negócio e loja estão registrados no DoorDash, preencha ambos em vez do endereço
Nome do negócio de coletaOpcionalO nome que o entregador vê na coleta
Telefone de coletaOpcionalUm telefone que o entregador pode ligar

Uber Direct

O Uber Direct é a rede de entregas sob demanda da Uber para os seus próprios pedidos: o LastMile cria as entregas a partir do seu ponto de coleta e as acompanha até a porta do cliente. Método de conexão: credenciais de cliente OAuth2 — o Client ID / Client Secret do seu app no direct.uber.com, sob o seu Customer ID.

CampoObrigatório?Onde obter
Client IDObrigatóriodirect.uber.com → Developer → seu app → credenciais API
Client SecretObrigatórioA mesma página; exibido uma vez
Customer IDObrigatóriodirect.uber.com → Developer → Customer ID (aparece na rota /v1/customers/{customer_id}/deliveries)
Endereço de coleta (JSON)ObrigatórioO endereço da sua loja / armazém como JSON, ex. {"street_address":["20 W 34th St"],"city":"New York","state":"NY","zip_code":"10001","country":"US"}. Necessário para criar entregas (não para o teste)
Nome de coletaOpcionalNome da loja exibido ao entregador (padrão “Merchant”)
Telefone de coletaOpcionalUm telefone que o entregador pode ligar

Fulfillment de marketplaces#

Amazon FBA

Esta conexão alimenta as telas de fulfillment de plataformas: sincronização de estoque FBA, estoque unificado entre seus armazéns e a Amazon, e alertas de reposição. Usa o mesmo conjunto de credenciais SP-API da conexão de canal Amazon SP-API acima, com um requisito extra: seu app SP-API precisa do papel “Amazon Fulfillment”.

CampoObrigatório?Onde obter
Seller IDObrigatórioSeller Central → Configurações → Informações da conta
Marketplace IDObrigatórioEUA: ATVPDKIKX0DER
LWA Client ID / SecretObrigatórioSeu app SP-API no Seller Central (precisa do papel Amazon Fulfillment)
Refresh TokenObrigatórioDo fluxo de autorização da Amazon
AWS Access Key ID / SecretObrigatórioChaves IAM da AWS para assinatura SigV4 (o segredo aparece uma vez)
IAM Role ARNOpcionalSó se assinar via STS AssumeRole; vazio = assinatura direta

Plataformas de devolução#

As plataformas de devolução cuidam do portal de devoluções do cliente e decidem o destino de cada devolução. Ao conectar uma, suas devoluções entram na gestão de devoluções do Docklify (RMS): seu armazém vê quais devoluções estão a caminho, processa-as na chegada e segue as decisões de disposição da plataforma.

Happy Returns

A Happy Returns (uma empresa da UPS) opera um portal de devoluções centrado em entregas presenciais em Return Bar e devoluções pelo correio. A conexão mantém a gestão de devoluções do Docklify (RMS) sincronizada com a Happy Returns: as mudanças de estado são enviadas ao Docklify quando os clientes iniciam devoluções e quando elas são aprovadas e recebidas. Método de conexão: uma chave API emitida na incorporação, enviada no cabeçalho “X-Hr-Apikey”.

CampoObrigatório?Onde obter
Chave APIObrigatórioEmitida pelo seu gerente de conta da Happy Returns na incorporação (página de configuração da API)
URL base da APIOpcionalSeu host de API comercial é atribuído na incorporação. Você pode deixar vazio por enquanto e preencher quando tiver o endereço

Loop Returns

O Loop Returns é um portal de devoluções para marcas de e-commerce: os clientes iniciam e acompanham devoluções no Loop, e a conexão permite que seu armazém trabalhe essas devoluções na gestão de devoluções do Docklify (RMS), marcando-as na chegada e processando-as na bancada. Método de conexão: uma chave API do painel do Loop, enviada no cabeçalho “X-Authorization”.

CampoObrigatório?Onde obter
Chave APIObrigatórioPainel do Loop → Returns Management → Tools & integrations → Developer Tools: crie uma chave com o escopo “returns”

ReturnGO

O ReturnGO é um portal de devoluções que gerencia toda a jornada, da solicitação do cliente ao reembolso. A conexão sincroniza seus pedidos de devolução (RMA) com a gestão de devoluções do Docklify (RMS), para o armazém consultar qualquer devolução e ver o que está voltando antes de chegar. Método de conexão: uma chave API mais o domínio da sua loja, enviados como cabeçalhos em cada chamada, junto com a URL do servidor API da documentação do ReturnGO.

CampoObrigatório?Onde obter
Chave APIObrigatórioPainel do ReturnGO → Settings → API: gere uma chave (uma chave pode gerenciar várias lojas)
Domínio da lojaObrigatórioO domínio da sua loja registrado no ReturnGO, ex. demo-store.myshopify.com (cabeçalho “x-shop-name”)
URL do servidor APIObrigatórioCopie a URL do servidor da seção Servers da documentação oficial da API do ReturnGO (Swagger)
Nome do cabeçalho da chave APIOpcionalNa maioria dos casos x-api-key. Se a ReturnGO der outro nome de cabeçalho ao conectar, use-o

Optoro

A Optoro decide para onde vai cada devolução — revenda, liquidação, retorno ao fornecedor, doação — para recuperar o maior valor do estoque devolvido. A conexão traz as decisões de disposição da Optoro para o Docklify, onde elas impulsionam os envios de saída para o canal escolhido. Método de conexão: credenciais de cliente OAuth 2.0 emitidas pela equipe de Client Success da Optoro.

CampoObrigatório?Onde obter
Client IDObrigatórioEmitido pela equipe de Client Success da Optoro ao habilitar seu acesso à API
Client SecretObrigatórioEmitido junto com o Client ID pela equipe de Client Success da Optoro