Informações |
---|
| Nesta guia veremos passo a passo para implantação do Importador XML com integração com TOTVS Transmite. O procedimento será dividido em duas etapas:
Implantação: Nesta etapa veremos passo a passo como preparar o ambiente Protheus para utilização do Importador XML; Parametrizações: Nesta etapa veremos as principais parametrizações do Importador XML. Exemplo: Configurações dos principais parâmetros, Documentos Importados, entre outros. |
Deck of Cards |
---|
effectDuration | 0.5 |
---|
id | Passo 1Implantação, Requisitos |
---|
effectType | slide |
---|
| Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | ConfiguraçõesImplantação |
---|
label | IMPLANTAÇÃO: |
---|
title | Configurações |
---|
effectType | slide |
---|
| Nota |
---|
Para uma implantação com êxito, solicitamos que seja seguido TODOS os passos das guias abaixo, iniciando por: Requisitos
Atenção: Recomendamos que não seja avançado para proxima próxima etapa sem a finalização da etapa atual! |
Deck of Cards |
---|
effectDuration | 0.5 |
---|
id | PassosRequisitos |
---|
effectType | slide |
---|
| Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | PassosRequisitos |
---|
label | REQUISITOS -> |
---|
title | Passos |
---|
effectType | slide |
---|
| Informações |
---|
IMPORTANTE: Com este procedimento, será criado algumas tabelas pertinentes ao processo de integração, sem elas não será possivel prosseguir com as configurações:
- Tabela DHW: Nesta tabela será gravado as configuração Grupo/Empresa que integra com o TOTVS Transmite
![](/download/attachments/841164088/image-2024-5-1_17-18-45.png?version=1&modificationDate=1714594725690&api=v2)
- Tabela DHY: Nesta tabela será gravado os Ids para consulta dos XML importados do TOTVS Transmite
![](/download/attachments/841164088/image-2024-5-1_17-18-27.png?version=1&modificationDate=1714594707447&api=v2)
- Tabela DHZ: Nesta tabela será gravado o histórico de Ids com erros e já importados no Importador XML.
![](/download/attachments/841164088/dhz.png?version=1&modificationDate=1714593796607&api=v2)
|
|
Card |
---|
effectDuration | 0.5 |
---|
id | Passos |
---|
label | PASSO 1 -> |
---|
title | Passos |
---|
effectType | slide |
---|
| Informações |
---|
Conector de Widget |
---|
url | http://youtube.com/watch?v=lJ_n6zHJ8AM |
---|
|
- Acesso o módulo Acesso o módulo Configurador (SIGACFG) -> Base de dados -> Dicionário -> Base de dados -> Buscar a tabela "CKO" e alterar o nome para "CKOCOL"
![](https://totvssuporte.zendesk.com/guide-media/01HKWAS8JWMBVZ8ECQ5N6JE0HH)
- Acesso o módulo Configurador (SIGACFG) -> Empresas ->Filial -> Posicionar na filial que receberá integração com TOTVS Transmite > Alterar > Preencher campos CNPJ ou CPF e Inscrição Estadual
![](/download/attachments/841164088/image-2024-5-1_18-6-29.png?version=1&modificationDate=1714597589727&api=v2)
- Valide as configurações no Portal do TOTVS Transmite em relação à inclusão da empresa, garantindo que todos os detalhes estejam conforme o cadastro no Protheus:
- Acesse o Portal do TOTVS Transmite > Faça login utilizando suas credenciais de acesso. - Verifique as Configurações da Empresa > Procure por uma seção ou página no Portal que exiba as configurações da empresa. - Compare com os Dados do Protheus: Compare as informações disponíveis no Portal do TOTVS Transmite com os dados cadastrados no sistema Protheus. Isso inclui detalhes como razão social, CNPJ, endereço, entre outros.
Mais detalhes em: Cross Segmentos - TOTVS Transmite – Como incluir e configurar uma nova empresa no Transmite?
Aviso |
---|
| Esses campos devem conter exatamente a mesma informação que foi cadastrada no TOTVS Transmite. |
|
|
Card |
---|
effectDuration | 0.5 |
---|
id | Passos |
---|
label | PASSO 2 -> |
---|
title | Passos |
---|
effectType | slide |
---|
| Conector de Widget |
---|
url | http://youtube.com/watch?v=JeyVLUuqcKk |
---|
|
Informações |
---|
- Criar uma pasta na Protheus_data - exemplo: "importadorxml"
- Criar duas subpastas dentro da pasta "importadorxml" chamadas: "inn" e "lidos"
![](/download/attachments/841164088/image-2024-5-1_18-9-39.png?version=1&modificationDate=1714597779647&api=v2)
- Configurar os parametros MV_NGINN e MV_NGLIDOS com os caminhos criados para as pastas conforme exemplo abaixo:
MV_NGINN: \importadorxml\inn
![](/download/attachments/841164088/image-2024-5-1_18-10-52.png?version=1&modificationDate=1714597852983&api=v2)
MV_NGLIDOS: \importadorxml\lidos
![](/download/attachments/841164088/image-2024-5-1_18-11-46.png?version=1&modificationDate=1714597906843&api=v2)
Aviso |
---|
OBSERVAÇÃO: As pastas devem constar no caminho Protheus_data, mantenha o diretório sem espaços . ATENÇÃO: Ambiente Linux não aceita diretório com letras maiúsculas. |
|
|
Card |
---|
effectDuration | 0.5 |
---|
id | Passos |
---|
label | PASSO 3 -> |
---|
title | Passos |
---|
effectType | slide |
---|
| Conector de Widget |
---|
url | http://youtube.com/watch?v=PTSZFYLohAI |
---|
|
Informações |
---|
- Alterar o parâmetro MV_IMPXML para ".T.".
![](/download/attachments/841164088/image-2024-5-1_18-14-42.png?version=1&modificationDate=1714598082967&api=v2)
|
|
Card |
---|
effectDuration | 0.5 |
---|
id | Passos |
---|
label | PASSO 4 -> |
---|
title | Passos |
---|
effectType | slide |
---|
| Conector de Widget |
---|
url | http://youtube.com/watch?v=WWU7cMlx-qE |
---|
|
Informações |
---|
| Informações |
---|
![d105beae-d862-4dbd-9bfd-d07d432765f8.gif](https://centraldeatendimento.totvs.com/hc/article_attachments/22885288884631)
Aviso |
---|
Importante: Executar a rotina até o final onde irá selecionar quais serão as empresas/filiais que deseja realizar a integração. |
|
|
Card |
---|
effectDuration | 0.5 |
---|
id | Passos |
---|
label | PASSO 5 -> |
---|
title | Passos |
---|
effectType | slide |
---|
| Conector de Widget |
---|
url | http://youtube.com/watch?v=TGiN9Ln36bI |
---|
|
Informações |
---|
- Configuração do Schedule: Neste Passo devemos realizar a criação dos seguintes agendamentos conforme indicado nas documentações a seguir:
- SCHEDIMPTRA : Responsável por requisitar os novos XMLs ao TOTVS Transmite para o Protheus na rotina Importador XML;
- SCHEDCOMCOL: Responsável por realizar a integração dos XMLs importados na tabela CKOCOL pelo agendamento SCHEDIMPTRA para o monitor do Importador XML; - SCHEDUPDTRA : Responsável por atualizar o campo "Integração ERP" do TOTVS Transmite referente aos XMLs importados ao Protheus através do Importador XML;
Agendamento | Descrição | Recorrência | Configuração | Consumo Licença |
---|
SCHEDIMPTRA | Para requisitar e ler recibos retornados do TOTVS Transmite | 144 (00:10 min) | Configurar apenas uma filial por grupo de empresa que ocorrera a importação Ex: T1 / D MG 01 T2 / D SP 01 Obs: Dessa forma ao importar XML será analisado se documento pertence a qualquer filial de cada grupo de empresa. | Por Empresa | SCHEDUPDTRA | Para atualizar status de documentos no TOTVS Transmite | 72 (00:20 min) | Configurar apenas uma filial por grupo de empresa que ocorrera a importação Ex: T1 / D MG 01 T2 / D SP 01 Obs: Dessa forma ao atualiza status será analisado toda a CKO, com documentos de todos grupos e filiais importados. | Por Empresa | SCHEDCOMCOL | Ler os XML's da CKO e importar para o monitor (SDS e SDT) | 288 (00:05 min) | Configurar TODOS os grupos e filiais que documentos possam pertencer para que sera importado para o monitor no grupo e filial correto Ex: T1 / D MG 01 T1 / D MG 02 T2 / D SP 01 T2 / D SP 02 | Por Filial |
Aviso |
---|
Atenção: O agendamento COLAUTOREAD não será utilizado na integração entre importador xml x transmite para garantir melhor performance no sistema, exceto em casos que são necessarios uma importação dos XMLs incluidos MANUALMENTE na pasta INN. Como é um cenario especifico, incluir a função COLAUTOREAD para execução pontual destes XMLs conforme atigo: Como executar as funções de carga SEM utilizar o Schedule
Observação: Cada execução de um dos agendamentos cadastrados será consumido uma licença do Compras, assim como ocorre no acesso via menu. |
|
|
Card |
---|
effectDuration | 0.5 |
---|
id | Passos |
---|
label | PASSO 6 -> |
---|
title | Passos |
---|
effectType | slide |
---|
| Conector de Widget |
---|
url | http://youtube.com/watch?v=HK-Ha9bZXB4 |
---|
|
|
Card |
---|
effectDuration | 0.5 |
---|
id | Passos |
---|
label | PRONTO! |
---|
title | Passos |
---|
effectType | slide |
---|
| Dica |
---|
Pronto! A Rotina Importador XML já está preparada para utilização do Importador XML integrado ao TOTVS Transmite, agora vá para sessão "PARAMETRIZAÇÕES" e realize as configurações de acordo com cada tipo de nota que será Importado! |
|
|
|
Card |
---|
effectDuration | 0.5 |
---|
id | parametrizações |
---|
label | PARAMETRIZAÇÕES: |
---|
title | parametrizações |
---|
effectType | slide |
---|
| Nota |
---|
Nesta etapa devemos realizar algumas parametrizações para atender a regra de negócio de cada empresa:
Atenção: Recomendamos que leia todos os conteúdos a seguir: |
Deck of Cards |
---|
effectDuration | 0.5 |
---|
id | parametrizacoes |
---|
effectType | slide |
---|
| Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | parametrizacoes |
---|
label | DOCUMENTOS IMPORTADOS -> |
---|
title | parametrizacoes |
---|
effectType | slide |
---|
| Listaremos os Documentos Importados pela integração Totvs Transmite x Importador XML Documento | Código | Tipo Requisição |
---|
NF-e | 109 | Recebimento | NFS-e | 319 | Recebimento | CT-e | 214 | Recebimento | CTEOS | 273 | Recebimento |
Saiba quais são os requisitos para que integração de cada tipo de documento funcione corretamente:
Aviso |
---|
Atenção: A importação do documento NFSe estará exclusivamente disponivel para integração do Importador XML com TOTVS Transmite. Caso não tenha essa integração, NÃO será possivel importar este tipo de documento! |
| Card |
---|
effectDuration | 0.5 |
---|
id | parametrizacoes |
---|
label | MONITOR -> |
---|
title | parametrizacoes |
---|
effectType | slide |
---|
| Aviso |
---|
Atenção: A importação do documento NFSe estará exclusivamente disponivel para integração do Importador XML com TOTVS Transmite. Caso não tenha essa integração, NÃO será possivel importar este tipo de documento! |
- Para validar os documentos que foram importados utilizando o Monitor do Importador XML, siga os passos indicados:
- Acesse: Módulo SIGACOM (COMPRAS) >Miscelânea → Importador XML → Monitor - Paramentros: Preencher as parametrizações conforme a necessidade, segue exemplo abaixo:
Image Removed |
|
|
|
| Configurações | PARÂMETROSPRINCIPAIS OCORRÊNCIAS! | title |
---|
|
|
|
|
| Configuraçõesparametrizacoes | effectType | slide |
---|
|
|
|
|
- Parâmetros utilizados na integração do Importador XML x Transmite:
Parâmetro | Tipo | Conteúdo | Descrição | Observação |
---|
|
MV_IMPXML | L | T | Habilita integração Importador XML | Parâmetro deve ser T para que integração com o TOTVS Transmite funcione. |
MV_DOCIMP | C | NFE/NFS/CTE/CTO | Tipo de XML a serem importados pela integração Importador XML x TOTVS Transmite | MV_XMLCID | C | Client ID do TOTVS Transmite | Informação virá do TOTVS Transmite. Para obter a credencial: - Na página Inicial do Transmite
- Clicar no símbolo
- Opção - Obter Credenciais
| MV_XMLCSEC | C | Client Secret do TOTVS Transmite | Informação virá do TOTVS Transmite Para obter a credencial: - Na página Inicial do Transmite
- Clicar no símbolo
- Opção - Obter Credenciais
| MV_XMLDIAS | N | 30 | Range dias para importar documentos do TOTVS Transmite. | Data Inicio: Data de hoje - MV_XMLDIAS (30)
Data Final: Data de hoje
MV_NGINN | C | Caminho para importar XMLs pelo Importador XML | Tratamento continuara funcionando mesmo com a integração com o TOTVS Transmite ativa Obs: Ambientes Linux deixar nomenclatura minúscula | MV_NGLIDOS | C | Caminho para onde o XMLs lidos da pasta IN serão armazenados. | Tratamento continuara funcionando mesmo com a integração com o Totvs Transmite ativa
Obs1: Ambientes Linux deixar nomenclatura minúscula
Obs2: Documentos originados via Totvs Transmite, não serão salvos na pasta LIDOS, pois XML's já são armazenados no Totvs Transite.
MV_APITRAN | C | production | Indica ambiente do Totvs Transmite (production / staging / development) | Default: production |
MV_DTINITR | D | 20230101 | Data de inicio da integração do Importador XML x TOTVS Transmite | Obs: Se não informar será solicitado TODOS documentos no TOTVS Transmite, caso tenha informado, somente a partir da data será selecionado documentos no TOTVS Transmite |