Para garantir o pleno funcionamento do PDV Omni, é essencial que os dados da loja estejam devidamente cadastrados. A partir dessas informações, o PDV Omni irá imprimir documentos fiscais e não fiscais, preencher as tags de XML das operações de venda e integrar-se ao ERP.

Abaixo listamos as informações essenciais para pleno funcionamento do PDV. 



1. Método para integração

Para maiores informações de como integrar a Loja, clique aqui.

2. Descrição de campos e regras

InformaçõesCampo banco PDVCampo Json APIObrigatórioTipoTamanhoDescrição
Código do loteN/AloteOrigemSimTexto
Código do lote
Razão socialrazao_socialrazaoSocialSimTexto50
Nome fantasianome_fantasianomeFantasiaSimTexto50
CNPJcnpjcnpjSimTexto20Enviar o campo sem formatação (sem ".", "/", "(", ")" ou "-")
Inscrição estadualinscricao_estadualinscricaoEstadualSimTexto15Enviar o campo sem formatação (sem ".", "/", "(", ")" ou "-")
Inscrição municipalinscricao_municipalinscricaoMunicipalNãoTexto15Enviar o campo sem formatação (sem ".", "/", "(", ")" ou "-")
EndereçoenderecoenderecoSimTexto200Rua
Número do endereçonumeronumeroSimTexto10
Complemento do endereçocomplementocomplementoNãoTexto100
Bairro do endereçobairrobairroSimTexto150
Cidade do endereçocidadecidadeSimTexto150
Estado do endereçoestadoestadoSimTexto50Exemplo "SÃO PAULO"
UF do endereçosigla_ufsiglaUfSimTexto20Exemplo "SP"
Código IBGE do estadocodigo_ibgeCodigoUFIBGESimTexto50
Código IBGE do municípiocodigo_municipio_ibgeCodigoMunicipioIbgeSimTexto50
CEP do endereçocepcepSimTexto10Enviar o campo sem formatação (sem ".", "/", "(", ")" ou "-")
TelefonetelefonetelefoneNãoTexto20Enviar campo com DDD+Telefone. Enviar o campo sem formatação (sem ".", "/", "(", ")" ou "-")
Código identificação da lojacodigo_identificacao_lojacodigoIdentificacaoLojaSimTexto20
SituaçãosituacaosituacaoSimInteiro
  • 0 - Inativo
  • 1 - Ativo

Deixar sempre como 1.

Data do cadastrodata_cadastroN/ASimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoN/ASimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
Modelo fiscalmodelo_fiscalmodeloFiscalSimInteiro
  • 0 - Não configurado
  • 1 -SAT
  • 2 - NFCe
  • 3 - MFe
Rede/GruporederedeSimTexto40
  • 0 - Default
  • 1 - Boticário
  • 2 - GrandCru
  • 3 - Totvs
  • 4 - PetCamp
  • 5 - CacauShow
  • 6 - Loreal
  • 7 - Maybelline
  • 8 - UnderArmor
  • 9 - NyxMakeup
  • 10 - Omnistory
  • 11 - TotvsChef
  • 12 - Qdb
  • 13 - Eudora
Regime tributárioregime_tributarioregimeTributarioSimInteiro
  • 0 - Simples nacional
  • 1 - Regime normal
Número identificaçãonumero_lojanumeroLojaSimTexto30Este campo pode ser o mesmo que o codigo_identificacao_loja, ou para alguns casos pode acontecer de ser retirado dígitos a direita (0 a direita)
Código de identificação no retaguardaid_retaguardaidRetaguardaSimTexto100
Código de identificação da rede no retaguardaid_retaguarda_redeidRetaguardaRedeSimTexto100
Código da mastercodigo_mastercodigoMasterSimTexto50
Nome da masternome_masternomeMasterSimTexto50
Id do inquilinoid_inquilinoidInquilinoNãoTexto250
Id de manutenção do domínioid_dominio_manutencaoidDominioManutencaoNãoTexto100
Utiliza PAFutiliza_pafN/ASimInteiro
  • 0 - False
  • 1 - True
Data atualização do PAFdata_atualizacao_pafN/ANãoData

Código da organizaçãocodigo_organizacionalN/ANãoTexto100

Deverá existir apenas 1 registro de loja no banco de dados dos PDV Omni, caso exista mais de um apenas o primeiro registro será considerado.

No momento da instalação do PDV o registro 1 é criado no banco de dados com informações básicas para que a integração consiga preencher o restantes dos campos. Essas informações são: 
Instalação via BUS: CNPJ, codigo_identificação_loja, data_cadastro, data_atualização
Instalação via Meu Suporte: CNPJ, codigo_identificação_loja, data_cadastro, data_atualização (em breve será adicionado o campo id_inquilino nessa instalação)

A configuração do modelo fiscal pode ser informada pela integração e também pode ser realizada diretamente no PDV Omni, através da opção de "Configurações do sistema".

Para mais informações consulte: https://tdn.totvs.com/pages/viewpage.action?pageId=805985408