Campos do cliente e da operação
Destinatário ou tomador
Os dados vêm de Administração/Serviços → Contatos e o contato é selecionado no Pedido de Venda. Preserve zeros à esquerda em CPF/CNPJ, CEP, Inscrição Estadual e códigos IBGE.
| Campo | Finalidade | Formato e exemplo | Aplicação e obrigatoriedade | Validação e consequência |
|---|---|---|---|---|
| Nome ou razão social | Identifica o destinatário ou tomador | Texto completo | Obrigatório para destinatário identificado | Nome incompleto pode impedir a emissão ou dificultar a identificação |
| CPF ou CNPJ | Identifica a pessoa | Apenas dígitos | Condicional conforme o documento e a operação | Dígito verificador inválido bloqueia ou rejeita a nota |
| Inscrição Estadual | Identifica o cadastro estadual | Texto conforme a UF; preserve zeros | Condicional para contribuintes de ICMS | Deve ser compatível com CNPJ, UF e indicador de contribuinte |
| Inscrição Municipal | Identifica o cadastro municipal | Texto conforme a prefeitura | Condicional em NFS-e | Deve corresponder ao município do tomador quando exigida |
| Indicador de contribuinte do ICMS | Classifica a situação estadual do destinatário | Selecione contribuinte, isento ou não contribuinte | Obrigatório em NF-e/NFC-e quando houver destinatário | Deve ser coerente com a Inscrição Estadual |
| Recebe o documento fiscal | Endereço de e-mail válido | Opcional, salvo regra operacional | E-mail inválido impede o envio automático | |
| Telefone | Identifica contato do destinatário | DDD e número | Condicional | Informe apenas dígitos válidos |
| CEP | Compõe o endereço | 8 dígitos | Condicional conforme o documento | CEP deve ser compatível com município e UF |
| Logradouro, número e bairro | Compõem o endereço | Texto completo | Condicional conforme o documento | Endereço incompleto pode causar rejeição |
| Município | Define município e código IBGE | Município cadastrado | Condicional conforme o documento | Código IBGE deve corresponder à UF |
| UF | Define o estado do destinatário | Sigla de 2 letras | Condicional conforme o documento | Afeta CFOP, partilha e regras interestaduais |
| País | Identifica operação nacional ou exterior | País cadastrado | Condicional | Deve ser coerente com endereço, CFOP e finalidade |
Campos comuns dos Pedidos de Venda
| Campo | Finalidade | Formato | Aplicação | Validação e consequência |
|---|---|---|---|---|
| Tipo de nota | Escolhe NFS-e Municipal, NFS-e Nacional, NF-e ou NFC-e | Selecione um documento habilitado na Unidade | Obrigatório para emitir | O tipo deve ser compatível com os itens do pedido |
| Contato | Define destinatário ou tomador | Contato cadastrado | Obrigatório no fluxo do Fipli | Dados fiscais incompletos devem ser corrigidos no cadastro |
| Descrição da operação | Complementa a descrição do serviço ou da venda | Texto claro e objetivo | Condicional | Evite informações ambíguas ou incompatíveis com os itens |
| Emitir ao salvar | Solicita a emissão após salvar o pedido | Sim ou não | Opcional | O pedido permanece salvo se a emissão falhar |
| Gerar nota ao gerar cobrança | Vincula emissão ao fluxo de cobrança | Sim ou não | Opcional | Use apenas no fluxo financeiro compatível |
| Gerar após confirmação do pagamento | Vincula emissão à confirmação financeira | Sim ou não | Opcional | Confirme se o meio de pagamento oferece confirmação automática |
Campos de NFS-e nos Pedidos de Venda
| Campo | Finalidade | Formato | M/S/P/R | Validação e consequência |
|---|---|---|---|---|
| Data de competência | Define quando o serviço pertence ao período fiscal | Data válida | O/O/O/O | Não pode contrariar a regra do município ou do Sistema Nacional |
| Usar a data de emissão como competência | Preenche a competência automaticamente | Sim ou não | O/O/O/O | Desmarque quando a competência for diferente da emissão |
| Enviar Inscrição Municipal | Inclui a Inscrição Municipal do prestador quando necessária | Sim ou não | C/C/C/C; emissão nacional | Marque apenas se a Unidade tiver uma inscrição válida |
| Descrição do serviço | Detalha o que foi prestado | Texto | O/O/O/O | Deve ser coerente com o Catálogo e com a classificação fiscal |
| Deduções e descontos | Ajustam a base e o valor líquido | Valores monetários não negativos | C/C/C/C | Não podem exceder o valor bruto |
| Retenções | Informam tributos retidos | Percentuais e valores não negativos | C/C/C/C | Responsabilidade, base, percentual e valor devem ser coerentes |
Campos de NF-e e NFC-e nos Pedidos de Venda
| Campo | Finalidade | Domínio ou formato | M/S/P/R | Validação e consequência |
|---|---|---|---|---|
| Natureza da operação | Descreve a operação fiscal | Texto | O/O/O/O | Deve ser coerente com CFOP e finalidade |
| Finalidade de emissão | Indica emissão normal, complementar, ajuste ou devolução | Selecione a finalidade aplicável | O/O/O/O | Finalidades diferentes da normal podem exigir documentos referenciados |
| Destino da operação | Identifica operação interna, interestadual ou exterior | Selecione conforme emitente e destinatário | O/O/O/O | Deve ser coerente com UF, país e CFOP |
| Consumidor final | Indica se o destinatário é consumidor final | Sim ou não | O/O/O/O | Afeta regras de ICMS e partilha |
| Presença do comprador | Informa como a operação ocorreu | Selecione a opção aplicável | O/O/O/O | Deve refletir atendimento presencial, internet, entrega ou outro cenário |
| Intermediador | Identifica participação de marketplace ou plataforma | Dados do intermediador, quando houver | C/C/C/C | Informe quando a operação ocorrer por intermediador |
| Informações complementares | Registra observações fiscais | Texto | C/C/C/C | Não use para substituir campos estruturados obrigatórios |
| Frete | Define modalidade e valor do frete | Modalidade e valor não negativo | C/C/C/C | Deve fechar com transportadora, volumes e total da nota |
| Seguro e outras despesas | Compõem o total quando aplicáveis | Valores não negativos | C/C/C/C | Valores devem fechar com a soma dos itens |
| Transportadora | Identifica quem transporta a mercadoria | Contato com CPF/CNPJ, IE e endereço | C/C/C/C | Dados incompletos podem rejeitar a NF-e |
| Veículo | Identifica placa e UF | Placa válida e UF | C/C/C/C | Informe quando exigido pela modalidade de transporte |
| Volumes | Informa quantidade, espécie, marca, numeração e pesos | Quantidade positiva; pesos não negativos | C/C/C/C | Peso líquido não deve superar o peso bruto |
| Pagamentos | Detalha formas e valores pagos | Meio de pagamento e valor | O/O/O/O na NFC-e; condicional na NF-e | A soma deve ser coerente com total e troco |
| Documento referenciado | Relaciona documento anterior | Chave de acesso ou dados do documento | C/C/C/C | Obrigatório em devolução, complemento ou ajuste quando aplicável |
Os domínios e regras oficiais constam no MOC 7.0.