MOVERE Software

1 - Introdução

Este documento tem o intuito de instruir o Analista/ Desenvolvedor sobre como é definida a estrutura dos dados para sincronização com o uMov.

1.1 - Escopo

O objetivo da transmissão de dados entre o MOVERE e o uMov, é realizar a sincronização de Itens (Inclui Família e Grupo), Clientes(inclui Histórico de venda e Títulos em Aberto), Condições de Pagamento e Pedidos de Venda(Orçamento).

2 - Gatilhos necessários para Sincronização de dados

Os gatilhos, à partir da versão 478, são ativados e/ou desativados automaticamente. Veja mais detalhes em: https://meajuda.moveresoftware.com/pt-BR/support/solutions/articles/27000063465-aplicativo-de-venda-externa-wizard-de-configura%c3%a7%c3%a3o

3 - Estratégia de integração

Por trás de toda integração existe uma estratégia que visa identificar quais registros são elegíveis para serem transmitidos. A estratégia adotada pelo Movere para identificar quais registros deverão ser transmitidos consiste em:

1. Identificar registros que sofreram alterações: Essa verificação é feita atualmente através da criação de gatilhos nas tabelas que serão integradas. Toda vez que um determinado registro de alguma tabela que participa da integração é alterado, o gatilho é disparado e preenche uma tabela auxiliar que é consultada pelo sistema de integração. Todos os registros presentes nas tabelas auxiliares devem ser enviados ao UMov.
2. Fazer a transmissão/sincronização dos registros com o UMov.
3. Excluir o registro da tabela auxiliar, já que a sincronização já foi feita.

No caso de uma implantação (Envio de todos os dados), o sistema não fará consultas nessa tabela auxiliar, pois supõe-se que é a "carga inicial", então todos os registros que participam da integração devem ser transmitidos/sincronizados.

4 - API da UMov

A uMov possui uma API que adota os conceitos REST. Dessa forma é possível "conversar" com o sistema através de solicitações HTTP, por meio dos verbos "GET" e "POST", utilizando "XML" para transmitir/receber registros.

Através do verbo "POST" conseguimos atualizar ou inserir um novo registro.

Ao enviar uma solicitação "POST" é necessário que o campo de cabeçalho "Content-Type" esteja preenchido com o valor "application/x-www-form-url-encoded".

O corpo da requisição deve ter o formato abaixo:

data=
<?xml version="1.0" encoding="utf-16"?>
<subGroup>
    <id>1343647</id>
    <description>CHRONO 2</description>
    <alternativeIdentifier>56</alternativeIdentifier>
    <active>true</active>
</subGroup>

5 - Sincronização

Antes de sincronizados itens, é necessário sincronizar os grupos e também as famílias, uma vez que o cadastro de itens possui relações com esses registros.

5.1 - Cadastro de Grupos De Itens 

POST https://api.umov.me/CenterWeb/api/{token}/subGroup.xml

Relação de campos padrões:

Exemplo do corpo de uma requisição válida:

data=
<?xml version="1.0" encoding="utf-16"?>
<subGroup xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <description>LT84</description>
  <alternativeIdentifier>1</alternativeIdentifier>
  <active>true</active>
</subGroup>

5.2 - Vínculo entre seção e subgrupo

Para que os itens enviados estejam disponíveis apenas nas suas respectivas atividades (fluxo), é necessário, logo após o envio de grupos de itens para o uMov, criar um vínculo entre os grupos e a seção.
Atualmente é possível vincular os itens à atividade de reforma ou de venda.  Para criar esse vínculo, é necessário enviar uma requisição, conforme abaixo:

POST https://api.umov.me/CenterWeb/api/{token}/batch/sectionSubGroups.xml

Relação de campos padrões:

Exemplo do corpo de uma requisição válida:

data=
<sectionSubGroups>
    <sectionSubGroup>
        <subGroup>
            <alternativeIdentifier>15728352</alternativeIdentifier>
        </subGroup>
        <section>
            <id>3892</id>
        </section>
    </sectionSubGroup>
    <sectionSubGroup>
        <subGroup>
            <alternativeIdentifier>15728352</alternativeIdentifier>
        </subGroup>
        <section>
            <id>3892</id>
        </section>
    </sectionSubGroup>
</sectionSubGroups>

5.3 - Cadastro de Famílias de Itens 

POST https://api.umov.me/CenterWeb/api/{token}/itemCategory.xml

Relação de campos padrões:

Exemplo do corpo de uma requisição válida:

data=
<?xml version="1.0" encoding="utf-16"?>
<itemCategory xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <description>PNEUS PASSEIO CONVENCIONAL</description>
  <alternativeIdentifier>1</alternativeIdentifier>
  <active>true</active>
</itemCategory>

5.4 - Cadastro de Itens 

POST https://api.umov.me/CenterWeb/api/{token}/batch/items.xml

Relação de campos padrões:

Relação de campos customizados:

Exemplo do corpo de uma requisição válida:

data=
<items>
    <item>
        <subGroup>
            <id>1171126</id>
        </subGroup>
        <description>1000-20 AS22 16PR TT</description>
        <alternativeIdentifier>9836</alternativeIdentifier>
        <active>true</active>
        <itemCategory>
            <id>75284</id>
        </itemCategory>
        <customFields>
            <UnidadeMedida>UN</UnidadeMedida>
            <Marca>PIRELLI</Marca>
            <QuantidadeFracionada>NAO</QuantidadeFracionada>
            <EmbalagemVenda>UNIDADE</EmbalagemVenda>
        </customFields>
    </item>
    <item>
        <subGroup>
            <id>1171186</id>
        </subGroup>
        <description>1000R20 FORMULA DRIVER TT 146/143L 16</description>
        <alternativeIdentifier>18501</alternativeIdentifier>
        <active>true</active>
        <itemCategory>
            <id>75284</id>
        </itemCategory>
        <customFields>
            <UnidadeMedida>UN</UnidadeMedida>
            <Marca>PIRELLI</Marca>
            <QuantidadeFracionada>NAO</QuantidadeFracionada>
            <EmbalagemVenda>UNIDADE</EmbalagemVenda>
        </customFields>
    </item>
</items>

5.5 - Cadastro de Estoque de Itens por Estabelecimento 

POST https://api.umov.me/CenterWeb/api/{token}/batch/customEntity/alternativeIdentifier/ESTOQUE/customEntityEntries.xml

Relação de campos padrões:

Relação de campos customizados:

Exemplo do corpo de uma requisição válida

data=<?xml version="1.0" encoding="utf-16"?>
<customEntityEntries>
    <customEntityEntry>
        <active>true</active>
        <alternativeIdentifier>1-25</alternativeIdentifier>
        <description>1-25-PNEU 195/70R14,WINTERFORCE,91S[CG]</description>
        <customFields>
            <Produto>1</Produto>
            <Estabelecimento>25</Estabelecimento>
            <QuantidadeEstoque>0</QuantidadeEstoque>
        </customFields>
    </customEntityEntry>
    <customEntityEntry>
        <active>true</active>
        <alternativeIdentifier>9-25</alternativeIdentifier>
        <description>9-25-PN 10.00-20TT 16L LD35[CG]</description>
        <customFields>
            <Produto>9</Produto>
            <Estabelecimento>25</Estabelecimento>
            <QuantidadeEstoque>0</QuantidadeEstoque>
        </customFields>
    </customEntityEntry>
    <customEntityEntry>
        <active>true</active>
        <alternativeIdentifier>1-100</alternativeIdentifier>
        <description>1-100-PNEU 195/70R14,WINTERFORCE,91S[CG]</description>
        <customFields>
            <Produto>1</Produto>
            <Estabelecimento>100</Estabelecimento>
            <QuantidadeEstoque>0</QuantidadeEstoque>
        </customFields>
    </customEntityEntry>
    <customEntityEntry>
        <active>true</active>
        <alternativeIdentifier>1-1</alternativeIdentifier>
        <description>1-1-PNEU 195/70R14,WINTERFORCE,91S[CG]</description>
        <customFields>
            <Produto>1</Produto>
            <Estabelecimento>1</Estabelecimento>
            <QuantidadeEstoque>66</QuantidadeEstoque>
        </customFields>
    </customEntityEntry>
    <customEntityEntry>
        <active>true</active>
        <alternativeIdentifier>9-100</alternativeIdentifier>
        <description>9-100-PN 10.00-20TT 16L LD35[CG]</description>
        <customFields>
            <Produto>9</Produto>
            <Estabelecimento>100</Estabelecimento>
            <QuantidadeEstoque>0</QuantidadeEstoque>
        </customFields>
    </customEntityEntry>
    <customEntityEntry>
        <active>true</active>
        <alternativeIdentifier>9-1</alternativeIdentifier>
        <description>9-1-PN 10.00-20TT 16L LD35[CG]</description>
        <customFields>
            <Produto>9</Produto>
            <Estabelecimento>1</Estabelecimento>
            <QuantidadeEstoque>445</QuantidadeEstoque>
        </customFields>
    </customEntityEntry>
</customEntityEntries>

5.6 - Preços e Custo de Reposição 

POST http://api.umov.me/CenterWeb/api/{0}/batch/customEntity/alternativeIdentifier/TABELAPRECO/customEntityEntries.xml

Relação de campos padrões:

Relação de campos customizados:

Exemplo do corpo de uma requisição válida:

data=
<customEntityEntries>
  <customEntityEntry>
    <active>True</active>
    <description>1-1-PRODUTO A</description>
    <alternativeIdentifier>1-1-111111</alternativeIdentifier>
    <customFields>
      <Estabelecimento>1</Estabelecimento>
      <TabelaPreco>1</TabelaPreco>
      <Item>111111</Item>
      <Preco>5.00</Preco>
      <Custo>2.89</Custo>
    </customFields>
  </customEntityEntry>
  <customEntityEntry>
    <active>True</active>
    <description>1-1-PRODUTO B</description>
    <alternativeIdentifier>1-1-222222</alternativeIdentifier>
    <customFields>
      <Estabelecimento>1</Estabelecimento>
      <TabelaPreco>1</TabelaPreco>
      <CodigoProduto>222222</CodigoProduto>
      <Preco>10.00</Preco>
      <Custo>5.95</Custo>
    </customFields>
  </customEntityEntry>
</customEntityEntries>

data=
<serviceLocals xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <serviceLocal>
    <corporateName>LEANDRO KLEIN MARCHALEK</corporateName>
    <alternativeIdentifier>411906</alternativeIdentifier>
    <cityNeighborhood>JD UBATA</cityNeighborhood>
    <state>MT</state>
    <city>CUIABA</city>
    <country>BRASIL</country>
    <description>411906LEANDRO KLEIN MARCHALEK</description>
    <street>CONDOMINIO MINAS APTO</street>
    <streetNumber>1923</streetNumber>
    <zipCode>78000-000</zipCode>
    <email>LEANDROK5@HOTMAIL.COM</email>
    <phoneNumber>36168500</phoneNumber>
    <cellphoneNumber>81364003</cellphoneNumber>
    <active>true</active>
    <customFields>
      <CodigoCliente>411906</CodigoCliente>
      <TipoPessoa>F</TipoPessoa>
      <SituacaoCredito>A</SituacaoCredito>
      <LimiteCredito>15000</LimiteCredito>
      <LimiteCreditoDisponivel>1163.36</LimiteCreditoDisponivel>
      <DataLimite>2017-08-09</DataLimite>
      <CPF>945.371.512-34</CPF>
      <CodigoDaTabelaDePreco>1</CodigoDaTabelaDePreco>
      <InscricaoEstadual>12316548</InscricaoEstadual>
    </customFields>
  </serviceLocal>
  <serviceLocal>
    <corporateName>14 BRASIL TELECOM CELULAR SA</corporateName>
    <alternativeIdentifier>7</alternativeIdentifier>
    <cityNeighborhood>CENTRO NORTE</cityNeighborhood>
    <state>DF</state>
    <city>BRASILIA</city>
    <country>BRASIL</country>
    <description>714 BRASIL TELECOM CELULAR SA</description>
    <street>SIA SUL ASP LT D BL D PARTE GUARA, 123</street>
    <zipCode>72000-000</zipCode>
    <email>TESTESDESENVOLVIMENTO@MOVERESOFTWARE.COM</email>
    <phoneNumber>36248500</phoneNumber>
    <cellphoneNumber/>
    <active>true</active>
    <customFields>
      <CodigoCliente>7</CodigoCliente>
      <TipoPessoa>J</TipoPessoa>
      <SituacaoCredito>A</SituacaoCredito>
      <LimiteCredito>400</LimiteCredito>
      <LimiteCreditoDisponivel>0</LimiteCreditoDisponivel>
      <DataLimite>2012-08-09</DataLimite>
      <CNPJ>05.752.800/0001-82</CNPJ>
      <CodigoDaTabelaDePreco>2</CodigoDaTabelaDePreco>
    </customFields>
  </serviceLocal>
</serviceLocals>

data=
<customEntityEntries>
<customEntityEntry>
    <active>True</active>
     <description>LOJA 01</description>
     <alternativeIdentifier>1</alternativeIdentifier>
</customEntityEntry>
@ Próximo Registro @
<customEntityEntry>
     <active>True</active>
     <description>LOJA 02</description>
     <alternativeIdentifier>2</alternativeIdentifier>
</customEntityEntry>
</customEntityEntries>

<result>
    <resourceName>sectionSubGroup</resourceName>
    <size>1</size>
    <entries>
        <entry id="319152" link="/sectionSubGroup/319152.xml"/>
    </entries>
</result>

data=
<customEntityEntries>
    <customEntityEntry>
        <active>True</active>
        <description>Título:000025 | Série: CH | Parcela: 1 | R$ 1420.00 | Vencto: 11/07/2016</description>
        <alternativeIdentifier>100375725CH0000251</alternativeIdentifier>
        <customFields>
            <Cliente>100375725</Cliente>
        </customFields>
    </customEntityEntry>
    <customEntityEntry>
        <active>True</active>
        <description>Título:000025 | Série: CH | Parcela: 2 | R$ 1421.00 | Vencto: 11/08/2016</description>
        <alternativeIdentifier>100375725CH0000252</alternativeIdentifier>
        <customFields>
            <Cliente>100375725</Cliente>
        </customFields>
    </customEntityEntry>
</customEntityEntries>

data=
<customEntityEntries>
    <customEntityEntry>
        <alternativeIdentifier>A VISTA</alternativeIdentifier>
        <description>A vista</description>
    </customEntityEntry>
    <customEntityEntry>
        <alternativeIdentifier>A PRAZO</alternativeIdentifier>
        <description>A prazo</description>
    </customEntityEntry>
</customEntityEntries>

data=<?xml version="1.0" encoding="utf-16"?>
<customEntityEntries xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <customEntityEntry>
    <description>A  VISTA DINHEIRO </description>
    <alternativeIdentifier>1</alternativeIdentifier>
    <active>false</active>
    <customFields>
      <SituacaoCondicaoPagamento>
        <alternativeIdentifier>A VISTA</alternativeIdentifier>
      </SituacaoCondicaoPagamento>
      <DescontoMaximoVenda>0</DescontoMaximoVenda>
      <AcrescimoFinanceiro>0</AcrescimoFinanceiro>
    </customFields>
  </customEntityEntry>
  <customEntityEntry>
    <description>BOLETO 10/20/30 DIAS AUTO CENTER</description>
    <alternativeIdentifier>360</alternativeIdentifier>
    <active>true</active>
    <customFields>
      <SituacaoCondicaoPagamento>
        <alternativeIdentifier>A PRAZO</alternativeIdentifier>
      </SituacaoCondicaoPagamento>
      <DescontoMaximoVenda>0</DescontoMaximoVenda>
      <AcrescimoFinanceiro>2</AcrescimoFinanceiro>
    </customFields>
  </customEntityEntry>
</customEntityEntries>

data=
<customEntityEntries>
<customEntityEntry>
               <active>True</active>
               <description>1-1-VENDEDOR A</description>
               <alternativeIdentifier>1-1</alternativeIdentifier>
               <customFields>
                           <Estabelecimento>1</Estabelecimento>
                           <CodigoVendedor>1</CodigoVendedor>
               </customFields>
</customEntityEntry>
<customEntityEntry>
              <active>True</active>
              <description>1-2-VENDEDOR A</description>
               <alternativeIdentifier>1-2</alternativeIdentifier>
               <customFields>
                          <Estabelecimento>2</Estabelecimento>
                          <CodigoVendedor>1</CodigoVendedor>
               </customFields>
</customEntityEntry>
</customEntityEntries>