Especificações de Serviços
Integração Aplicativo Minha Produção com ERP Datasul
O objetivo desta integração é permitir que usuários do ERP Datasul possam reportar ordens de produção diretamente através do aplicativo, reduzindo assim o retrabalho e a utilização de folhas de papel.
O Aplicativo Minha Produção permite a customização dos formulários de reporte, dando a liberdade ao usuário de escolher quais campos serão exibidos, ocultados ou desabilitados. Também é possível definir valores padrões para cada campo, fazendo com que eles já sejam carregados com essa informação sempre que for realizado um novo apontamento.
Pré-requisitos para instalação do APP
Smartphone ou tablet com Android a partir da versão 5.0;
Acesso à internet para baixar o aplicativo e para sincronizar as informações do APP com o ERP;
Usuário e Senha de acesso ao Datasul;
Cadastro do Alias de Acesso no Mingle (somente para conexão via Totvs Mingle).
Importante
Para solicitar a criação do Alias, acesse o endereço: https://mingle.totvs.com.br/landpage/.
Programas rest chamados nas rotinas do APP
fchmanproductionmobile.p
fchmanproductionStopMobile.p
Parâmetros que as rotinas rest recebem
Todos os programas rest recebem como parâmetros JSON, e tem que ser chamados via Basic Authentication informando Usuário e Senha.
Buscar os formulários vinculados ao usuário logado
Chamada REST
http:// servidor : porta /dts/datasul-rest/resources/api/fch/fchman/fchmanproductionmobile/buscaFormulariosUsuario
Método: POST
Body:
{
"usuario": "<Código do usuário>
}
Resposta:
{
"data": {
"ttFormulario": [
{
"tipo_reporte": 1,
"codigo": "001",
"usa_cronometro": false,
"tipo_progresso": 1,
"reporta_parada": false,
"apontar_e_novo": false,
"icone": "print",
"finaliza_op": false,
"descricao": "MONTAGEM"
}
]
}
}
Buscar dados da Ordem
Traz os principais dados da ordem de produção selecionada para reporte e monta a temp-table ttFields para ser exibida no formulário.
Chamada REST
http:// servidor : porta /dts/datasul-rest/resources/api/fch/fchman/fchmanproductionmobile/buscaDadosOrdem
Método: POST
Body:
{
"cod_form": "001",
"numero_ordem": 10007861,
"cod_ctrab": ""
}
Resposta:
{
"data": [
{
"field_id": "nr-ord-produ",
"field_disable": true,
"field_data": "1000786",
"field_maxchars": 0,
"field_barcode": false,
"cod_form": "001",
"field_type": "number",
"field_hidden": false,
"field_precision": 0,
"field_name": "Ordem de Produção"
}
[ ... demais campos ... ]
}
}
Reporte de Produção
Realizar o reporte da ordem conforme os dados informados no formulário de apontamento
Chamada REST
http:// servidor : porta /dts/datasul-rest/resources/api/fch/fchman/fchmanproductionmobile/apontaOrdem
Método: POST
Body:
{
"ttFormularioOrdem": {
"cod_form": "001",
"numero_ordem": 1000789,
"cod_ctrab": ""
},
"ttFields": [
{
"field_id": "nr-ord-produ",
"field_disable": true,
"field_data": "1000789",
"field_maxchars": 0,
"field_barcode": false,
"cod_form": "001",
"field_type": "number",
"field_hidden": false,
"field_precision": 0,
"field_name": "Ordem de Produção"
}
{ ... demais campos ... ]
]
}
Inicia reporte
Inicializa o split da operação da ordem selecionada.
Chamada REST
http:// servidor : porta /dts/datasul-rest/resources/api/fch/fchman/fchmanproductionmobile/iniciaReporte
Método: POST
Body:
{
"numero_ordem": 1000798,
"cod_ctrab": "ct-acidos",
"num_split_operac": 1,
"dat_inic_reporte": "11/08/2021",
"hra_inic_rep": "1508",
"cod_operador": "10",
"cod_equipe": "",
"num_operac_sfc": 1
}
Resposta:
{
"data": [
{
"cod_operador": "10",
"numero_ordem": 1000798,
"hra_inic_rep": "1508",
"cod_ctrab": "ct-acidos",
"num_split_operac": 1,
"num_operac_sfc": 1,
"dat_inic_reporte": "15/09/2021",
"cod_equipe": "",
"split_iniciado": false
}
],
"length": null,
"messages": []
}
