Data de publicação: 02/10/2026

🎯 Objetivo

Esclarecer o comportamento do campo:

A1_PFISICA — RG/Ced.Estr.

no Cadastro de Clientes do TOTVS Protheus — SIGAFAT, especificamente quando o CNPJ do cliente está em branco e existe a expectativa de que o sistema gere automaticamente o campo:

A1_COD — Código do Cliente

A TOTVS esclarece que o preenchimento do A1_PFISICA não possui a funcionalidade padrão de gerar automaticamente o código do cliente. Central de Atendimento TOTVS

🧩 Ambiente

• Produto: TOTVS Backoffice — Linha Protheus
• Módulo: SIGAFAT — Faturamento
• Processo: Cadastro de Clientes
• Versões: Todas as versões
• Tabela: SA1 Central de Atendimento TOTVS

🔎 Cenário

Durante o cadastro de um cliente, principalmente do tipo estrangeiro, pode ocorrer a seguinte situação:

A1_CGC     = Em branco
A1_PFISICA = Preenchido
A1_COD     = Não gerado automaticamente

Nesse cenário, o comportamento é esperado.

O campo:

A1_PFISICA

não substitui o CNPJ como mecanismo para geração automática do:

A1_COD

e não existe, no processo padrão descrito pela TOTVS, uma regra que utilize o RG/Cédula de Estrangeiro para criar automaticamente o código do cliente. Central de Atendimento TOTVS

⚙️ Campo A1_PFISICA

O campo:

A1_PFISICA

é apresentado no cadastro como:

RG/Ced.Estr.

Seu preenchimento pode ser utilizado para armazenar essa identificação do cliente, porém não aciona a criação automática do código A1_COD quando o CNPJ está em branco. Central de Atendimento TOTVS

🧠 E a função A030VldUCod?

A TOTVS informa que a validação relacionada a esse processo utiliza a função:

A030VldUCod

Entretanto, essa função possui finalidade específica relacionada à integração:

Protheus x Datasul

no conceito de:

Código Único

Não se trata, portanto, de uma funcionalidade criada para gerar o código do cliente com base no conteúdo do A1_PFISICA. Central de Atendimento TOTVS

🔄 Código Único na integração Protheus x Datasul

No cenário de integração mencionado pela TOTVS, é possível fazer com que a rotina crie o código do cliente de acordo com o código de um fornecedor que possua o mesmo:

CNPJ
+
Inscrição Estadual

Esse comportamento pertence especificamente ao processo de Código Único da integração Protheus SIGATMS x Datasul. Central de Atendimento TOTVS

📊 Resumo do comportamento

⚠️ Ponto de atenção

Caso o cliente seja estrangeiro e não possua CNPJ brasileiro, não se deve esperar que o preenchimento de:

A1_PFISICA

gere automaticamente:

A1_COD

O código do cliente deverá seguir o processo normal de cadastramento definido no ambiente, salvo quando existir alguma regra específica de integração ou customização.

✅ Resultado esperado

O comportamento padrão pode ser resumido da seguinte forma:

A1_PFISICA preenchido
        ↓
Não gera automaticamente A1_COD

A função A030VldUCod não altera essa regra, pois sua finalidade está associada ao processo de Código Único na integração Protheus x Datasul. Central de Atendimento TOTVS

💡 Boas práticas

• não utilizar A1_PFISICA esperando a geração automática do código do cliente;
• diferenciar o cadastro padrão do processo específico de Código Único;
• verificar se existem customizações locais para geração do A1_COD;
• em clientes estrangeiros, manter o cadastro conforme as regras específicas para Cliente Tipo Exterior;
• antes de alterar validações padrão, verificar se o ambiente possui integração Protheus x Datasul.

❓ FAQ

1. Preencher o A1_PFISICA gera automaticamente o A1_COD?

Não. A TOTVS informa que essa funcionalidade não existe no comportamento padrão. Central de Atendimento TOTVS

2. Isso ocorre porque o CNPJ está em branco?

Mesmo com o CNPJ em branco, o A1_PFISICA não passa a ser utilizado para gerar automaticamente o A1_COD. Central de Atendimento TOTVS

3. Para que serve a função A030VldUCod nesse contexto?

Ela está relacionada à validação do Código Único na integração Protheus x Datasul. Central de Atendimento TOTVS

4. Existe algum cenário em que o código pode ser criado com base em outro cadastro?

Sim. Na integração mencionada pela TOTVS, o código do cliente pode ser criado de acordo com o código do fornecedor que possua o mesmo CNPJ e Inscrição Estadual. Central de Atendimento TOTVS

🔗 Referência oficial

TOTVS — Cross Segmentos — TOTVS Backoffice Linha Protheus — SIGAFAT — Campo “RG/Ced.Estr.” (A1_PFISICA) não gera o código do cliente. Central de Atendimento TOTVS

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria

“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”