Microvix

A Dito extrai os dados através da API disponibilizada pela Microvix.

Credencial necessária

• Microvix Key (Token).

Informações obrigatórias antes das extrações de dados

• Lista dos IDs dos CFOPs de vendas e devoluções que devem ser considerados para cálculo do faturamento das lojas.

🚧

Importante!

CFOP é o Código Fiscal de Operações e Prestações.

Esses códigos identificam as operações por categoria no momento da emissão da nota fiscal e nem todas são consideradas pelo financeiro das marcas para compor a receita.

Por isso o envio dessa lista dos IDs dos CFOPs validada pela marca para a Dito é tão importante antes do início das extrações dos dados, para que não haja divergências no momento de validar a receita da marca na Dito.

Extração dos dados

Para extração dos dados, a Dito dito acessa apenas um endpoint, mudando apenas o corpo da requisição para acessar as Lojas, Produtos, Clientes, Vendedores e Transações:

Endpoint: https://webapi.microvix.com.br/1.0/api/integracao

Grupo de lojas - Corpo da requisição para obter os dados:

<?xml version="1.0" encoding="utf-8"?>
<LinxMicrovix>
    <Authentication user="linx_export" password="linx_export" />
    <ResponseFormat>csv</ResponseFormat>
    <Command>
        <Name>LinxGrupoLojas</Name>
        <Parameters>
            <Parameter id="chave">TOKEN</Parameter>
        </Parameters>
    </Command>
</LinxMicrovix>

Produtos - Corpo da requisição para obter os dados:

<?xml version="1.0" encoding="utf-8"?>
<LinxMicrovix>
    <Authentication user="linx_export" password="linx_export" />
    <ResponseFormat>csv</ResponseFormat>
    <IdPortal>295</IdPortal>
    <Command>
        <Name>LinxProdutos</Name>
        <Parameters>
            <Parameter id="chave">TOKEN</Parameter>
            <Parameter id="cnpjEmp">11629461000225</Parameter>
            <Parameter id="id_setor">NULL</Parameter>
            <Parameter id="id_linha">NULL</Parameter>
            <Parameter id="id_marca">NULL</Parameter>
            <Parameter id="id_colecao">NULL</Parameter>
            <Parameter id="dt_update_inicio">NULL</Parameter>
            <Parameter id="dt_update_fim">NULL</Parameter>
        </Parameters>
    </Command>
</LinxMicrovix>

Clientes - Corpo da requisição para obter os dados:

<?xml version="1.0" encoding="utf-8"?>
<LinxMicrovix>
    <Authentication user="linx_export" password="linx_export" />
    <ResponseFormat>csv</ResponseFormat>
    <Command>
        <Name>LinxClientesFornec</Name>
        <Parameters>
            <Parameter id="chave">TOKEN</Parameter>
            <Parameter id="cnpjEmp">25270948000198</Parameter>
            <Parameter id="data_inicial">1759-01-01</Parameter>
            <Parameter id="data_fim">9999-12-31</Parameter>
            <!-- <Parameter id="dt_update_inicial">2023-01-01</Parameter> -->
            <Parameter id="dt_update_inicial">2022-12-31</Parameter>
            <Parameter id="dt_update_fim">2023-01-02</Parameter>
        </Parameters>
    </Command>
</LinxMicrovix>

Vendedores - Corpo da requisição para obter os dados:

<?xml version="1.0" encoding="utf-8"?>
<LinxMicrovix>
    <Authentication user="linx_export" password="linx_export" />
    <ResponseFormat>csv</ResponseFormat>
    <Command>
        <Name>LinxVendedores</Name>
        <Parameters>
            <Parameter id="chave">TOKEN</Parameter>
            <Parameter id="cnpjEmp">22939305000287</Parameter>
            <!-- <Parameter id="cod_vendedor">1145</Parameter> -->
            <Parameter id="data_upd_inicial">NULL</Parameter>
            <Parameter id="data_upd_fim">NULL</Parameter>
        </Parameters>
    </Command>
</LinxMicrovix>

Lojas - Corpo da requisição para obter os dados:

<?xml version="1.0" encoding="utf-8"?>
<LinxMicrovix>
    <Authentication user="linx_export" password="linx_export" />
    <ResponseFormat>csv</ResponseFormat>
    <Command>
        <Name>LinxLojas</Name>
        <Parameters>
            <Parameter id="chave">TOKEN</Parameter>
            <Parameter id="cnpjEmp">17097431000544</Parameter>
        </Parameters>
    </Command>
</LinxMicrovix>

Transações - Corpo da requisição para obter os dados:

<?xml version="1.0" encoding="utf-8"?>
<LinxMicrovix>
    <Authentication user="linx_export" password="linx_export" />
    <ResponseFormat>csv</ResponseFormat>
    <IdPortal>16427</IdPortal>
    <Command>
        <Name>LinxMovimento</Name>
        <Parameters>
            <Parameter id="chave">TOKEN</Parameter>
            <Parameter id="cnpjEmp">46925421000124</Parameter>
            <Parameter id="data_inicial">2023-06-30</Parameter>
            <Parameter id="data_fim">2023-06-30</Parameter>
        </Parameters>
    </Command>
</LinxMicrovix>

Horário da extração

Todos os acessos ocorrem de madrugada entre 0h e 3h, exceto o primeiro acesso onde iremos pegar a carga retroativa completa do cliente e o tempo de processamento vai depender da quantidade de dados que o cliente possui.

Plano de tracking:

A estrutura dos dados que serão obtidos é padronizada neste tipo de integração, ou seja, não é possível alterar, nem incluir novos tipos de dados.

Dados dos Usuários

Dados dos Eventos

👍

Caso haja necessidade de alterar ou enviar outros dados que não estão no plano de tracking, é necessário que seja utilizada uma integração customizada.