Docs

Guias do produto, rotinas operacionais e integrações da Plataforma

Guia prático4 min de leitura

Cadastro de clientes

Como cadastrar clientes no OSBPulse — dados principais, contatos, endereços e papel na emissão de notas.

Abra Cadastros → Cliente. A tela usa lista à esquerda e detalhe à direita (no celular, a lista e o detalhe se empilham). No detalhe, as abas do formulário ficam à esquerda (como no cadastro de produto).

Fluxo básico

  1. Clique em Novo (ou equivalente) e preencha a aba Principal.
  2. Salve o registro.
  3. As abas Contato e comunicação, Endereços, Fiscal (Brasil), Pedidos (e CRM, se o módulo estiver ativo) ficam disponíveis após o primeiro salvamento.

Aba Principal

  • Documento fiscal — escolha o país (Brasil, Estados Unidos ou China) e informe o documento:
    • Brasil: CPF/CNPJ (validação automática; a UI indica pessoa física ou jurídica). Com CNPJ válido, o Pulse consulta os dados públicos da empresa e preenche nome fantasia, razão social, e-mail, telefone, inscrição estadual (quando disponível) e o endereço de sede (gravado ao salvar), sem sobrescrever o que você já digitou. Use o ícone de atualizar ao lado do documento para tentar a consulta de novo. Quando o endereço vem da consulta, aparece a nota Endereço principal carregado.
    • Estados Unidos: EIN/SSN (9 dígitos).
    • China: código de crédito social da empresa (USCI, 18 caracteres) ou documento de identidade da pessoa (18 caracteres).
  • Depois de salvar com um documento válido, o campo não pode mais ser alterado.
  • Nome (pessoa física) ou Nome fantasia e Razão social (pessoa jurídica / empresa).
  • Inscrição estadual — quando a operação exigir (PJ no Brasil). Pode vir preenchida pela consulta do CNPJ; se houver mais de uma na consulta, use o ícone no campo para ver ativas/inativas e escolher. Fica nesta aba; o restante do perfil fiscal fica na aba Fiscal.
  • Dados pessoais (só CPF) — com documento brasileiro de pessoa física, aparecem (opcionais): nome social, gênero (masculino / feminino) e estado civil. Em CNPJ esses campos não são exibidos.
  • E-mail e Telefone principal (com país/DDI).

Para emissão de NF-e no Brasil, o destinatário ainda precisa de CPF ou CNPJ. Cadastros com documento estrangeiro ficam disponíveis para comercialização, mas a emissão fiscal brasileira continua bloqueada até haver regras de estrangeiro (fora deste cadastro).

Mantenha documento e razão social alinhados ao cadastro oficial do país: esses dados identificam a contraparte.

Aba Fiscal (Brasil)

Disponível depois de salvar, quando o documento do cliente é brasileiro:

  • Indicador de IE — contribuinte, isento ou não contribuinte (ou automático pela inscrição estadual).
  • Consumidor final — automático, ou forçar sim/não.
  • CFOP sugerido — escolha na tabela nacional (ex.: 6109 Suframa). Usado na emissão se o item não tiver CFOP.
  • SUFRAMA / Zona Franca — só aparecem quando o endereço fiscal (ou o padrão / sede, nessa ordem) estiver em UF elegível (AM, AC, RO, RR, AP). Inclui número SUFRAMA, tipo de isenção (ICMS / PIS-Cofins / ambos / sem) e flag de zona. Se já houver dado preenchido fora dessas UFs, os campos continuam visíveis para correção. O número SUFRAMA em geral não vem da consulta gratuita de CNPJ — informe manualmente (validação automática de status fica para evolução).

Esses dados entram no destinatário da NF-e (incluindo SUFRAMA no XML quando informado).

Contato e comunicação

Disponível depois de salvar:

  • Telefones da empresa — número e tipo (ex.: Comercial, WhatsApp).
  • Pessoas de contato — nome, função, e-mail, telefone e se está ativo.

Endereços

Tipos comuns: Sede, Entrega, Fiscal, Outro. Marque um endereço como padrão quando fizer sentido.

No tipo Fiscal, use Mesmo que sede para copiar o endereço da sede sem preencher o formulário de novo (é preciso ter uma sede cadastrada). Desmarque o toggle se o fiscal for diferente.

Campos típicos: país, CEP (com busca no Brasil), logradouro, número, complemento, bairro/distrito, cidade, estado/província e observações.

O lápis e o mapa abrem o conteúdo na própria linha (um de cada vez). Clicar no mesmo ícone fecha; clicar em outro endereço ou no outro ícone troca o painel. Novo endereço começa em branco.

O endereço fiscal / padrão é o mais relevante para a nota: município e UF entram no destinatário da emissão.

Relação com pedidos e NF-e

  • Pedidos e orçamentos usam o cliente como parte.
  • Na Fiscal → Emissão de NF, o destinatário precisa de CPF ou CNPJ válido. Se faltar documento no cadastro (ou no snapshot da nota), o checklist pré-emissão bloqueia a transmissão até corrigir.

Relacionado