B4 Guia

Passo 6 · Integrações: API, B4 Plug e CDI

As opções dos grupos Integrações, B4 Plug e CDI: o que liga cada sincronização, as chaves ocultas e o que é preciso ter antes de ligar.

Sistema: SoftWay Comercial (Retaguarda) · Atualizado em 21/11/2026

Conteúdo criado com apoio de inteligência artificial · em revisão pela equipe da B4 System

As integrações trocam dados com serviços da família B4 pela internet. Ligar uma integração sem o resto pronto não funciona: leia o que cada opção exige. O padrão de todas é Desligado.

As chaves são segredo

As chaves de integração aparecem ocultas (asteriscos). Use o botão Ver só se precisar conferir e nunca mande uma chave por e-mail ou mensagem aberta. Quem gera as chaves é a B4 System.

#Grupo Integrações

Opção na tela Onde fica gravada Padrão
Sincronizar contas a receber (API) ConfigSWS.ini, [SERVICES] ContaReceberSync Desligado
Sincronizar contas a pagar (API) ConfigSWS.ini, [SERVICES] ContaPagarSync Desligado
Sincronizar envase (API) ConfigSWS.ini, [SERVICES] EnvaseSync Desligado
  • Sincronizar contas a receber (API): envia contas a receber e baixas para a API.
  • Sincronizar contas a pagar (API): envia contas a pagar para a API.
  • Sincronizar envase (API): sincroniza os dados de envase, em intervalos automáticos.

As três só funcionam com a integração com a API ativada no sistema. Sem isso, ligar não faz efeito.

#Grupo B4 Plug

Opção na tela Onde fica gravada Padrão
Sincronizar estoque com o B4 Plug ConfigSWS.ini, [SERVICES] EstoquePlugSync Desligado
Endereço do B4 Plug (Host) ConfigSWS.ini, [B4PLUG] Host https://plug.appb4system.com.br
Chave da API (ApiKey) ConfigSWS.ini, [B4PLUG] ApiKey vazio (campo oculto)
Campo que identifica a mercadoria (CampoChave) ConfigSWS.ini, [B4PLUG] CampoChave CodPeca

Endereço do B4 Plug, chave oculta com o botão Ver e o campo que identifica a mercadoria

  1. Endereço do B4 Plug (Host): o endereço da API, começando com https://.
  2. Botão Ver da Chave da API (ApiKey), gerada no B4 Plug em Configurações > API.
  3. Campo que identifica a mercadoria (CampoChave): CodPeca (código da peça) ou SKU (o SKU cadastrado). É o mesmo campo da tela de envio de SKU para o B4 Plug.
  • Sincronizar estoque com o B4 Plug: o sistema consulta, de tempos em tempos, as pendências de estoque do B4 Plug e aplica no cadastro de mercadorias.
Só roda no computador Server

No código, a sincronização de estoque com o B4 Plug só roda no computador marcado como Server (veja o passo 8) e com a sincronização ligada. Ao mudar as opções de B4 Plug, o sistema relê a configuração na hora.

#Grupo CDI

Opção na tela Onde fica gravada Padrão
Enviar pacotes ao CDI ConfigSWS.ini, [SERVICES] CdiEnviar Desligado
Receber pacotes do CDI ConfigSWS.ini, [SERVICES] CdiReceber Desligado
Chave do CDI ConfigSWS.ini, [SERVICES] CdiChave vazio (campo oculto)
  • Enviar pacotes ao CDI: aparece o botão Enviar ao CDI na Consulta de Vendas (impressão de documentos), para mandar os valores de revenda ao parceiro pela nuvem. Só funciona com a chave do CDI preenchida e com a empresa habilitada a ENVIAR no cadastro da B4. Desligada, o envio não aparece (o arquivo manual Exportar revenda continua).
  • Receber pacotes do CDI: aparece o botão Baixar do CDI na Entrada de Mercadoria e na importação de preços de revenda. Só funciona com a chave do CDI e com a empresa habilitada a RECEBER. É independente do envio: uma empresa pode só enviar ou só receber.
  • Chave do CDI: gerada pela B4 na aba Licença do cadastro da empresa no Master. Fica oculta.

Veja o uso nos assuntos Etiquetas de revenda e envio ao CDI e Importação de preços de revenda.

© 2026 B4 System · B4 Guia, manual de treinamento. Material criado com apoio de inteligência artificial e em revisão pela equipe da B4 System; pode conter imprecisões. Os exemplos usam dados fictícios e as telas são ilustrações geradas a partir do sistema.