Permitir a integração de dados entre a solução TOTVS RFID e o ERP Datasul.
Entidades de integração:
Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).
Rotinas disponíveis na integração através do TOTVS RFID:
*Para conferência/separação por pedido é necessário trabalhar com alocação física no ERP.
Filial TOTVS RFID
BC0112 - Parâmetros TOTVS RFID
BC0106 - Parametrização de itens TOTVS RFID
Carga de depósitos TOTVS RFID
Não se aplica.
Não se aplica.
Não se aplica.
As integrações são realizadas através de serviços REST que já são disponibilizados juntamente com a instalação do ERP TOTVS, se faz apenas necessária as configurações na instalação do TOTVS RFID através do arquivo rfid.properties contido dentro do servidor de aplicação em que o TOTVS RFID está instalado.
Esse arquivo deverá conter as informações:
erp.type=DATASUL
erp.url=http://<ambiente>:<porta>/rfid/resources
Dentro do servidor de aplicação do Datasul, deverá ser parametrizado o arquivo rfid,properties conforme path a seguir:
<servidor>/server/<instancia>/conf/datasul/rfid.properties
Esse arquivo deverá conter a parametrização de usuário e senha que irá autenticar a integração do TOTVS RFID com o ERP, exemplo:
rfid.totvs.rest.user=super
rfid.totvs.rest.pass=super@123
Essas são as únicas configurações a nível de ambiente que necessitam ser realizadas para a integração entre as duas soluções.
Não se aplica.
Não se aplica.
Não se aplica.
O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
Observação: Este modelo de suporte está sendo revisado pela TOTVS.
<context>/rfid/resources/item/filial/all
RESPONSE
[{
"codigo": "1",
"nome": "Produto 1",
"codigoBarras": "7898176580238"
},{
"codigo": "2",
"nome": "Produto 2",
"codigoBarras": "7898176580244"
}]
<context>/rfid/resources/deposito/filial/all
RESPONSE
[{
"codDepos": "1",
"nome": "Depósito 1",
"locais": [
"001",
"002"
]
},{
"codDepos": "D2",
"nome": "Depósito 2",
"locais": []
},{
"codDepos": "3",
"nome": "Depósito 3",
"locais": [
"L03",
"L04"
]
}]
Recupera o saldo dos produtos inventariados.
No corpo da requisição deverá constar os seguintes dados:
POST
<context>/rfid/resources/saldoInventario?estabelecimento={filial}&id={id_inventario}
id_inventario: Data do inventário no formato "DD-MM-YYYY"
REQUEST
[{
"codigo": "<código do item>",
"referencia": "<referência do item>",
"loteSerie": "<lote do item>",
"deposito": "<serie do item>",
"local": "<localização do item>"
}]
RESPONSE
[{
"codigo": "123",
"referencia": 'branco',
"loteSerie": "",
"deposito": "ALM",
"localizacao": "A",
"saldo": 123
},{
"codigo": "123",
"referencia": 'branco',
"loteSerie": "123",
"deposito": "ALM",
"local": "B",
"saldo": 154
}]
POST
<context>/rfid/resources/inventario?estabelecimento={filial}&id={id_inventario}
id_inventario: Data do inventário no formato "DD-MM-YYYY"
REQUEST
[{
"codigo": "<código do item>",
"referencia": "<referência do item>",
"deposito": "<deposito do item>",
"local": "<localização do item>",
"loteSerie": "<lote/serie do item>",
"quantidade": "<quantidade apurada>",
"epcs": {
"epc": "1999999999999999999999DC",
"epc": "2999999999999999999999DC"
},
},{
"codigo": "<código do item>",
"referencia": "<referência do item>",
"deposito": "<deposito do item>",
"localizacao": "<localização do item>",
"loteSerie": "<lote/serie do item>",
"quantidade": "<quantidade apurada>",
"epcs": {
"epc": "9999999999999999999999DC",
"epc": "8999999999999999999999DC"
},
}]
Recupera o saldo de um item lido no coletor
No corpo da requisição deverá constar os seguintes dados:
POST
<context>/rfid/resources/saldoItem?estabelecimento={filial}
REQUEST
[{
"codigo": "<código do item>",
"referencia": "<referência do item>",
"loteSerie": "<lote do item>"
}]
RESPONSE
[{
"deposito": "ALM1",
"locais": [{
"local": "A",
"saldo": 1
},{
"local": "B",
"saldo": 2
}]
},{
"deposito": "ALM2",
"locais": [{
"local": "",
"saldo": 3
}]
},{
"deposito": "ALM3",
"locais": [{
"local": "A",
"saldo": 3
}]
}]
Realiza a transferência de itens entre locais e depósitos
No corpo da requisição deverá conter os seguintes dados:
POST
<context>/rfid/resources/transferencia?estabelecimento={filial}
REQUEST
[{
"codigo": "1",
"origemDeposito" : 1,
"origemLocal" : "1",
"destinoDeposito" : "1",
"destinoLocal": ""
"itens":[
"codigo": "14",
"referencia" : 1,
"loteSerie" : "1",
"quantidade" : 2,
"epcs" : [
"72D97B2CC0100100000843DC",
"72D97B2CC0100100000821DC"
]
},{
"codigo": "1",
"origemDeposito" : 1,
"origemLocal" : "1",
"destinoDeposito" : "1",
"destinoLocal": "1"
"itens":[
"codigo": "P12",
"referencia" : 1,
"loteSerie" : "1",
"quantidade" : 2,
"epcs" : [
"72D97B2CC0100100000843DC",
"72D97B2CC0100100000821DC"
]
}]
Busca itens dos documentos para conferência e separação para os tipos:
POST
<context>/rfid/resources/conferencia?estabelecimento={filial}&tipo={tipo}
Acessando o programa de impressão de etiquetas no terminal de trabalho, o operador deverá informar o número da nota fiscal para que este apresentar os itens e lotes recebidos. Os itens contidos no documento da nota fiscal são checados se possuem integração com o TOTVS RFID, através do seu cadastro no BC0106 com o preenchimento do campo "Código de Integração RFID". Itens que não possuem essa relação são listados na tela de impressão porem não são integrados com o TOTVS RFID.
Para cada fluxo de informação descreva, se necessário, alterações de comportamento que o respectivo produto irá sofrer. Por exemplo: quando o Logix recebe o PEDIDO de OUTRO ERP, este pedido não poderá ser alterado no Logix.
Liste quais as entidades integradas e como é o mapeamento entre as diferentes estruturas. Por exemplo: Classe no sistema A vira categoria no sistema B, o campo X é refletido no campo Y etc.
Liste quais transações/operações a integração fará com as entidades relacionadas. Exemplo: Insert de PEDIDO, Insert, update de ITEM, buscar saldo em estoque do ITEM no dia X ou buscar dados do FUNCIONÁRIO.
Todos os processos são de responsabilidade do produto TOTVS RFID, para mais informações deverá ser consultado o manual de referência deste produto.
Somente serão integrados com o TOTVS RFID itens que estejam importados no módulo de coleta de dados BC0106 e que possuam o Código Integ. RFID informado.
Instalação/Configuração
Checklist de Verificações: