Abaixo listamos algumas diretrizes a serem seguidas:

1ª - Existem apenas dois modelos de Layout, sendo um layout de integração por TABELA e outro layout via ARQUIVO XML. Fica a critério de cada integradora escolher qual layout será utilizado;

2ª - Só serão aceitas informações externas se enviadas exatamente conforme solicitado em algum dos layout´s exibidos a seguir;

3ª - Estes layouts não irão se distinguir por integradora, sendo o mesmo para todas;

4ª - Alterações no layout serão realizadas apenas para implementações de novas regras ou correção de erros mediante solicitação do cliente.

1. Este documento exibe o layout padrão por tabelas que a integradora deverá utilizar para realizar o envio de informações diversas para importação no Winthor. Está divido em tabelas, sendo necessário realizar a inserção dos dados coletados para posterior processamento;

2. Para este tipo de integração, é necessário que o DBA (Database Administration) responsável da empresa crie permissões de leitura, gravação e alteração em todas as tabelas listadas abaixo para um usuário específico (definido pela integradora);

3. Toda a inserção de um novo registro é obrigatório o envio do campo IMPORTADO com valor igual a 1. Este campo é utilizado como referência de processamento do pedido e, receberá 3 valores possíveis:

• 1 - Não Processado
• 2 - Processado e aceito pelo WinThor
• 3 - Rejeitado

Observação: os valores 2 e 3 são atualizados somente após importação do registro pelo WinThor.

4. Todas as tabelas de importação possuem o campo OBSERVAÇÃO_PC onde são retornadas críticas sobre a importação dos dados enviados;

5. Não é obrigado o envio de dados para todas as tabelas relacionadas abaixo, podendo ser enviado apenas as de necessidade do cliente;

6. O nome do programa de importação (package utilizada para validar os dados e gravá-los no Winthor) é INTEGRADORA, e seu método de execução é IMPORTARPEDIDO, passando como parâmetro Tipo de leitura que corresponde ao valor do campo importado descrito acima, Data inicial e Data Final, obedecendo ao seguinte exemplo:

Integradora.importarpedido(tipoleitura,‘datainicial’,’datafinal’)

Fica a critério da empresa integradora em executar o programa para importação das informações. Porém, também existem recursos no Winthor para este processo (Rotina 2596 – Integração Dados Externos).

Este documento exibe o layout padrão que a Integradora deverá utilizar quando optar pela a opção por Arquivo.

Observação: os campos CODCLI deverão ser informados no caso de vendas realizadas para clientes que tenham o CNPJ duplicado (utilizado por outro cliente) na base de dados.

Exemplo de Formatação do Arquivo:

<?xml version="1.0" ?>

<LOTE>

  <NUMEROLOTE>123486</NUMEROLOTE>

  <CLIENTES>

    <TIPOOPERACAO>I</TIPOOPERACAO>

    <CGCENT>05.324.469/0001-08</CGCENT>

    <CLIENTE>RAZÃO SOCIAL</CLIENTE>

    <FANTASIA>NOME FANTASIA DO CLIENTE DE TESTE</FANTASIA>

    <IEENT>ISENTO</IEENT>

    <IMENT>ISENTO</IMENT>

    <CODCLIPALM>123456</CODCLIPALM>

    <CODATV1>1</CODATV1>

    <ENDERENT>ENDERECO PARA CADASTRO NO SISTEMA</ENDERENT>

    <NUMEROENT>2121</NUMEROENT>

    <COMPLEMENTOENT>QD.01 LT.15A</COMPLEMENTOENT>

    <BAIRROENT>SETOR SUL</BAIRROENT>

            <!Demais registros...>

  </CLIENTES>

  <RECADOS>

    <CODFUNCDEST>10</CODFUNCDEST>

    <ASSUNTO>ASSUNTO</ASSUNTO>

    <TEXTORECADO>TEXTO DE RECADO DE TESTE</TEXTORECADO>

    <NUMRECADOFV>1</NUMRECADOFV>

    <CODUSUR>10</CODUSUR>

  </RECADOS>

  <CONTATOS>

    <CGCCLI>05.324.469/0001-08</CGCCLI>

    <NOMECONTATO>CONTATO DE TESTE</NOMECONTATO>

    <TIPOCONTATO>F</TIPOCONTATO>

    <CGCCPF>66446830106</CGCCPF>

    <DTNASCIMENTO>01/10/1985</DTNASCIMENTO>

    <HOBBIE>MUSICA</HOBBIE>

    <TIME>TIME</TIME>

    <NOMECONJUGE>CONJUGUE DA SILVA</NOMECONJUGE>

    <DTNASCCONJUGE>01/09/1986</DTNASCCONJUGE>

    <ENDERECO>ENDERECO</ENDERECO>

            <!Demais registros...>

  </CONTATOS>

  <PEDIDO>

    <CABPEDIDO>

      <IMPORTADO>1</IMPORTADO>

      <NUMPEDRCA>1000000101</NUMPEDRCA>

      <CODUSUR>0010</CODUSUR>

      <CGCCLI>11421265000180</CGCCLI>

      <DTABERTURAPEDPALM>25/06/2012 11:25:15</DTABERTURAPEDPALM>

      <DTFECHAMENTOPEDPALM>25/06/2012 11:27:32</DTFECHAMENTOPEDPALM>

      <CODFILIAL>1</CODFILIAL>

      <CODCOB>DH</CODCOB>

      <CODPLPAG>1</CODPLPAG>

      <CONDVENDA>1</CONDVENDA>

      <ORIGEMPED>F</ORIGEMPED>

            <!Demais registros...>

    </CABPEDIDO>

    <ITEMPEDIDO>

      <NUMPEDRCA>1000000101</NUMPEDRCA>

      <CGCCLI>11421265000180</CGCCLI>

      <CODUSUR>0010</CODUSUR>

      <DTABERTURAPEDPALM>25/06/2012 11:25:15</DTABERTURAPEDPALM>

      <CODPROD>1152</CODPROD>

      <QT>1.0</QT>

      <PVENDA>5.7</PVENDA>

      <NUMSEQ>1</NUMSEQ>

    </ITEMPEDIDO>

  </PEDIDO>

</LOTE>

Observações:

1. Com exceção da TAG de registro XML “<?xml version="1.0" ?>”, as demais TAGS deverão ser gravadas em Maiúsculas e uma TAG por linha;

2. Casas decimais deverão ser separadas por ponto;

3. É de suma importância para os processos do Winthor, que os DTABERTURAPEDPALM e DTFECHAMENTOPEDPALM sejam gravados no formato “DD/MM/AAAA HH:MM:SS”.

Este tópico tem por objetivo orientar sobre o processo de atualização dos registros de pedidos, com relação às alterações sofridas nesses pedidos ao longo do tempo após sua importação.

Tabelas envolvidas: PCPEDCFV, PCPEDIFV e PCPEDCFVMANIF.

• Tabela PCPEDCFV:
  No cabeçalho do pedido, o campo RETORNO é gravado inicialmente com o valor ‘2’ após o processamento do registro. Assim que for realizada a leitura deste registro, orientamos que este seja alterado para qualquer valor diferente de ‘2’, pois, na medida em que o pedido vai sendo atualizado/alterado no WinThor, este campo é novamente gravado com o valor ‘2’, indicando assim, que houveram alterações no pedido.
  
  A nível cabeçalho, os campos que poderão ser atualizados são:
  
  - POSICAO_ATUAL – Se faturado, cancelado, bloqueado, etc.
  - GEROUBRINDE – Nulo para Não e ‘S’ para indicar que gerou brinde.
  
  
• Tabela PCPEDIFV:
  
  Nos itens do pedido, o campo que poderá sofrer alterações são:
  
  - QT_FATURADA – Quantidade atendida do item. Se ocorrer algum corte, este campo receberá o novo valor. Se seu valor receber um ‘0’ (zero), significará que todo o item foi cortado.
  
  Observação: o campo CORTE é gravado com o valor ‘S’, somente quando o item é cortado durante a importação do pedido, pois existem parâmetros no WinThor que permitem a importação de produtos sem estoque, com posição ‘P’ (Pendente), e para este caso, os cortes poderão ser realizados após sua importação.
  
  
• Tabela PCPEDCFVMANIF:
  
  Caso o pedido seja para gerar NF-e, os campos NUMNOTA e SERIE não poderão ser preenchidos, sendo necessário gravar apenas uma Flag no campo GERARNFE, com valor ‘S’.
  O campo SITUACAONFE será gravado e atualizado, durante o processo de validação da nota junto à SEFAZ. Já o campo NUMTRANSVENDA, será preenchido com um código, para a localização do XML gerado para o pedido, após a aprovação da nota pela SEFAZ. Com este código, deverá ser buscado na tabela PCDOCELETRONICO, utilizando o campo equivalente NUMTRANSACAO, para se obter no campo XMLNFE (campo do tipo CLOB) o XML gerado.

• O campo RETORNO será a Flag indicando que essas alterações foram ocorrendo no pedido, onde será gravado o valor ‘2’, devendo este ser alterado para qualquer outro valor, diferente de ‘2’, após sua leitura, da mesma forma que ocorre para os pedidos de venda/bonificação.

• O campo CONTINGENCIATV14 deverá ser gravado com um ‘S’ apenas nos casos que houve necessidade de geração de DANFE em modo Contingência, conforme legislação vigente de cada estado. Os demais campos TIPOEMISSAO, CHAVENFE e JUSTIFICATIVACONTIGENCIA, deverão ser gravados conforme Manual NF-e em vigência.

• O campo DTAHORAENTRADACONTIGENCIA deverá ser preenchido no formato data e hora, com o valor referente ao momento em que a nota em contingência foi emitida no palm. Os dados gerados em modo contingência são de responsabilidade do gerador, não sendo atualizados pelo WinThor, ou seja, poderão ocorrer divergências entre os dados gerados no sistema (cálculo de impostos, etc), obrigatórios para o faturamento do pedido, e os dados gerados pelo palm, presentes na DANFE impressa em contingência.
• O número da nota fiscal bem como a série deverão ser informados, e estes serão repassados para a SEFAZ, e devem ser obtidos ou não no cadastro de Rotas, vinculado ao cadastro do RCA (Vide legislação / norma / termo de ajuste / com relação à permissão de uso ou não de um número de série de notas fiscais por mais de um RCA).

• A geração dos dados para emissão de boleto nas vendas pronta entrega (Manifesto), ocorrerá quando no campo GERARBOLETOAUTOVENDAMANIF for gravado o valor ‘S’. Através dos valores gravados nos campos NUMPED e NUMTRANSVENDA, após o faturamento do pedido, será possível obter os dados para impressão do boleto (LINHADIG, NOSSONUMBCO, CODBARRA) buscando essas informações na tabela PCPREST. A formatação do layout do boleto é de responsabilidade do prestador de serviços de Força de Vendas.

• Para obter a numeração de nota e série para utilização em caso de contingência, os campos PROXNUMNFETV14 e SERIENFETV14 da tabela PCROTAEXP deverão ser consultados, utilizando para isso o campo CODROTA vinculado ao cadastro do RCA, na tabela PCUSUARI. Toda nota que for emitida em modo normal, irá disparar uma atualização e o valor do campo PROXNUMNFETV14 será atualizado automaticamente, ou seja, deverá ser feito um controle desta numeração, para que ao ser enviado uma nota em contingência o número não se repita ou salte. Também é importante que seja bloqueado o envio de pedidos para emissão de DANFE on line, caso tenha qualquer nota emitida em contingência ainda sem ter sido enviada no aparelho. Assim que houver sinal de internet, todas as notas emitidas em contingências deverão ser enviadas para a INTEGRADORA.
  
  Observação: não são realizados cortes para itens de venda manifesto após a importação. Logo, não são realizadas alterações na tabela de itens.

Abaixo, descrição das últimas alterações efetuadas no documento, especificando o responsável, a data e a alteração realizada.