Índice

Objetivo

O objetivo da API é retornar todos os Funcionários ou Executantes disponíveis para realizar as operações de Calibragem e Medição de Sulco.

Header

Os parâmetros que deverão ser adicionados no header para possibilitar a utilização da api são:

Variável	Descrição	Obrigatório	Exemplo
authorization	Ao executar a chamada do webservice, deverá ser configurado para Basic Auth utilizando usuário e senha do Protheus.	Sim	Basic Y0BuZ2kuY29tLmJyOjE
tenantId	Código da empresa + Código da Filial	Sim	T1,D MG 01
x-erp-module	Representa o módulo do Protheus	Sim	GFR

O valor inserido na variável tenantId não deverá possuir espaço entre a vírgula;
No exemplo apresentado na tabela acima, T1 corresponde a uma empresa e D MG 01 a uma filial.
O campo x-erp-module deve ser preenchido apenas com a abreviação de três letras do módulo, sem o prefixo "SIGA", conforme indicado no exemplo.

Endpoints

Método: rest/mntExecutantes

Tipo: Get

Exibe as informações dos Funcionários ou Executantes disponíveis para realizar as operações de Calibragem e Medição de Sulco

curl --request GET\
--url http://localhost:8080/rest/mntExecutantes
--header 'Authorization: Basic YWRtaW46MTIzNA==' \
--header 'tenantId: T1,D MG 01' \
--header 'x-erp-module: GFR' \

Regras de Negócio

Caso o conteúdo do X3_F3 do campo TTO_EXECUT seja 'CAD', os dados retornados serão da tabela SRA, caso contrário, serão exibidos os dados da tabela ST1.
Caso os dados sejam da tabela SRA, os funcionários com situação demitidos ou transferidos ( RA_SITFOLH = 'D' ou 'T' ) não serão exibidos.

Retorno da requisição

Estrutura da Requisição

Exemplo:

{
    "executantes": [
        {
            "codigo": "000001",
            "nome": "JOAO DA SILVA ",
            "filial": "D MG 01 "
        },
        {
            "codigo": "000002",
            "nome": "GTP001",
            "filial": "D MG 01 "
        }
    ]
}

Campos

Nome	Tipo	Regra
codigo	Caractere	Contém o código do Funcionário (SRA) ou Executante (ST1).
nome	Caractere	Nome do Funcionário
filial	Caractere	Código da Filial do Funcionário

Informações Adicionais

Integração via API; https://www.totvs.com/blog/inovacoes/integracao-via-api/
API reference Totvs; https://api.totvs.com.br/;
Caso esteja ocorrendo algum problema, verificar a seção de dúvidas frequentes, no link http://tdn.totvs.com/x/J4HpDw.
API mntEstrutura: Integração Protheus(SIGAGFR/Pneus) com Budini