Páginas filhas
  • API Depósitos Manutenção Automotiva

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 Disponibilizado endpoint para integração do cadastro de Depósito com os métodos GET, POST, PUT, PATCH e DELETE.


Estrutura:

Grupo Material Grupo Material Grupo MaterialfgCustoOS de Custos da O.S.Flag de Custos de AbastecimentoFlag de Custos de LubrificaçãoFlag Controlador de Exportação para o ERP

Atributos

Descrição

Tamanho

Tipo

Chave Primária

Requerido

Valor Default

Valores Válidos

Observação

tipoPonto

Flag para indicar o tipo do ponto se abastecimento ou manutenção

1

STRING

N

S

A

A = Abastecimento | M = Manutenção

-

instancia

Código da instância relacionada ao ponto de abastecimento/manutenção

5

STRING

N

N

-

Instância cadastrada

Caso não informada será atribuída a instância padrão configurada em default-instance.

codigo

Código do

ponto de

abastecimento/manutenção

45

NUMBER

SS

N

-

-

Caso não informado será gerado automaticamente quando o registro é inserido na tabela.

descricaoAbreviada

Descrição Abreviada do

ponto de

abastecimento/manutenção

10

STRING

N

N

-

-

Caso não informada será atribuído o valor do atributo "descricao" limitado a 10 caracteres.

descricao

Descrição Completa do

ponto de

abastecimento/manutenção

40

STRING

N

S

N-

-

-

movelFixo

Flag

para indicar se o ponto de abastecimento/manutenção é móvel ou fixo

1

STRING

N

S

F

M = Móvel | F = Fixo

-

captaCusto

Apontamentos realizados no ponto de abastecimento/manutenção serão captados pelo CUSTAG

1

STRING

N

S

N-

S = Sim | N = Não

-

fgCustoAbastecimento

exportaERP

Apontamentos realizados no ponto de abastecimento/manutenção serão exportados para o ERP

1

STRING

N

S

N-

S = Sim | N = Não

fgCustoLubrificacao

-

empresaERP

Código da empresa no ERP relacionada ao ponto de abastecimento/manutenção

15

STRING

N

N

-

-

-

organizacaoERP

Código da organização no ERP relacionada ao ponto de abastecimento/manutenção

15

STRING

N

N

-

-

-

depositoERP

Código do depósito no ERP relacionado ao ponto de abastecimento/manutenção

15

STRING

N

N

-

-

-

pontoERP

Código do ponto de abastecimento/manutenção no ERP

12

STRING

N

N

-

-

-

pontoCTF

Código do ponto de abastecimento no CTF

5

NUMBER

N

N

-

-

-

pontoGTFrota

Código do ponto de abastecimento no GTFrota

8

STRING

N

N

-

-

-

tipoRavoTag

Forma de identificação RAVO/TAG do ponto de abastecimento no GTFrota

1

STRING

N

N

-

S R = Sim | N = Não

fgExportaErp

RAVO | T = TAG

Obrigatório quanto tipoPonto = 'A' e MNF_ABAST/ FG_MNF_GTFROTA = 'S'

codigoRavoTag

Código de identificação RAVO/TAG do ponto de abastecimento no GTFrota

19

STRING

N

N

-

-

-

origem

Origem do ponto de manutenção

1

STRING

N

N

-

S = Exporta | N = Não exporta

I

I = Interna | C = Campo | T = Terceiros | E = Concessionária

Obrigatório quanto tipoPonto = 'M'

prestadorServico

Código do prestador de serviço do ponto de manutenção

8

NUMBER

N

N

-

Prestador de serviço cadastrado e ativo

Obrigatório quanto tipoPonto = 'M' e origem = 'T' ou 'E'

tempoMedioAtendimento

Tempo Médio entre a finalização de uma manutenção de um equipamento e o ínicio em outro equipamento

7,2

NUMBER

codigoErp

Código de Relacionamento com o ERP

15

STRING

N

N

0

-

Se informado, valor deve ser menor ou igual a 24

dataValidade

Data para inativação do ponto de abastecimento/manutenção

10

DATE

N

S

31/12/2099

Data válida

-


GET (Consulta Grupos de MateriaisDepósitos)

http:127.0.0.1:8080/api/entity/v1/grupoMateriaispontoAbast?page=1&pagesize=201

Bloco de código
languagejava
titleResponse
{
    "hasNext": falsetrue,
    "items": [
		{{
            "instancia": "11",
            "codigo": 1,
            "descricaoAbreviada": "VACO05",
            "descricao": "11-VACO02-DESTILARIA",
            "codigoErpmovelFixo": "M",
            "captaCusto": "S",
            "exportaERP": "S",
            "empresaERP": "00001101",
            "descricaoAbreviadaorganizacaoERP": "GRP TESTE101",
            "depositoERP": "VIRTCOMB05",
            "descricaopontoERP": "VIRTCOMB05",
            "GRUPO TESTE DE MATERIAIS""pontoCTF": null,
            "pontoGTFrota": null,
            "fgCustoOStipoRavoTag": null,
 "S"           "codigoRavoTag": null,
            "fgCustoAbastecimentoorigem": "ST",
            "fgCustoLubrificacaoprestadorServico": 110000,
            "StempoMedioAtendimento": 0,
            "fgExportaErpdataValidade": "S2999-12-31T00:00:00",
		            "rowversion": 194456
        }
	]
}

Parâmetros

  • page: Número da página.
  • pagesize: Quantidade máxima de registros por página.

...

- Todos os atributos podem ser usados como parâmetro para a busca.


POST (Cadastra Grupo de MaterialDepósitos)

http:127.0.0.1:8080/api/entity/v1/grupoMateriaispontoAbast

Estrutura de dados para envio:

Bloco de código
languagejava
titleBody
collapsetrue
{
	"codigo    "tipoPonto": 1"A",
	"codigoErp": "00001",
	    "instancia": "11",
    "codigo": 2000,
    "descricaoAbreviada": "GRP TESTE11070007",
	    "descricao": "GRUPO TESTE DE MATERIAIS",
	"fgCustoOS12-CAM COMB 11070007",
    "movelFixo": "M",
    "captaCusto": "S",
	"fgCustoAbastecimento    "exportaERP": "S",
	"fgCustoLubrificacao": "S",
	"fgExportaErp": "S",
    "empresaERP": "150",
    "organizacaoERP": "150",
    "depositoERP": "VIRTCOMB01",
    "pontoERP": "VIRTCOMB01",
    "pontoCTF": 12,
    "pontoGTFrota": "M002",
    "tipoRavoTag": "R",
    "codigoRavoTag": "900000000000000M002",
    "origem": "C",
    "prestadorServico": null,
    "tempoMedioAtendimento": 0,
    "dataValidade": "2999-12-31T00:00:00"
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
	"codigo    "tipoPonto": 1"A",
	"codigoErp    "instancia": "00001",
	"11",
    "codigo": 2000,
    "descricaoAbreviada": "GRP TESTE11070007",
	    "descricao": "12-CAM COMB 11070007"GRUPO,
   TESTE DE MATERIAIS"movelFixo": "M",
	"fgCustoOS    "captaCusto": "S",
	"fgCustoAbastecimento    "exportaERP": "S",
	"fgCustoLubrificacao": "S",
	"fgExportaErp": "S",
	    "empresaERP": "150",
    "organizacaoERP": "150",
    "depositoERP": "VIRTCOMB01",
    "pontoERP": "VIRTCOMB01",
    "pontoCTF": 12,
    "pontoGTFrota": "M002",
    "tipoRavoTag": "R",
    "codigoRavoTag": "900000000000000M002",
    "origem": "C",
    "prestadorServico": null,
    "tempoMedioAtendimento": 0,
    "dataValidade": "2999-12-31T00:00:00",
    "rowversion": 1
}

Observações

  • Caso o atributo codigo não for informado na requisição, será atribuído automaticamente o primeiro código disponível que for encontrado a partir do 1 até o final da sequência 99999.
  • Caso o atributo instancia não for informado na requisição, será utilizado como default o valor definido no parâmetro default-instance.


PUT e PATCH (Atualiza Grupo de MaterialDepósitos)

http:127.0.0.1:8080/api/entity/v1/grupoMateriaispontoAbast

Estrutura de dados para envio:

Bloco de código
languagejava
titleBody
collapsetrue
{
	"codigo    "tipoPonto": 1"A",
	"codigoErp    "instancia": "0000111",
	    "codigo": 2000,
    "descricaoAbreviada": "GRP TESTE11070007",
	    "descricao": "12-CAM COMB 11070007"GRUPO,
   TESTE DE MATERIAIS"movelFixo": "M",
	"fgCustoOS    "captaCusto": "S",
	"fgCustoAbastecimento    "exportaERP": "S",
	"fgCustoLubrificacao": "S",
	"fgExportaErp": "S",
    "empresaERP": "150",
    "organizacaoERP": "150",
    "depositoERP": "VIRTCOMB01",
    "pontoERP": "VIRTCOMB01",
    "pontoCTF": 12,
    "pontoGTFrota": "M002",
    "tipoRavoTag": "R",
    "codigoRavoTag": "900000000000000M002",
    "origem": "C",
    "prestadorServico": null,
    "tempoMedioAtendimento": 5,
    "dataValidade": "2999-12-31T00:00:00"
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
	"codigo    "tipoPonto": 1"A",
	"codigoErp    "instancia": "00001",
	11",
    "codigo": 2000,
    "descricaoAbreviada": "GRP TESTE11070007",
	    "descricao": "GRUPO TESTE DE MATERIAIS",
	"fgCustoOS12-CAM COMB 11070007",
    "movelFixo": "M",
    "captaCusto": "S",
	"fgCustoAbastecimento    "exportaERP": "S",
    "empresaERP": "150",
    "organizacaoERP": "150",
    "depositoERP": "VIRTCOMB01",
    "pontoERP": "VIRTCOMB01",
    "pontoCTF",
	"fgCustoLubrificacao: 12,
    "pontoGTFrota": "M002",
    "tipoRavoTag": "R",
    "codigoRavoTag": "900000000000000M002",
    "origem": "SC",
	"fgExportaErp    "prestadorServico": null,
    "StempoMedioAtendimento": 5,
	"rowversion    "dataValidade": 1
}"2999-12-31T00:00:00"
}

Observações

  • Caso o atributo pontoERP for informado e o atributo codigo não for informado na requisição, o ponto será localizado através do atributo pontoERP informado.
  • Caso o atributo instancia não for informado na requisição, será considerada a instância atual do ponto para as eventuais validações necessárias.


DELETE (Apaga Grupo de MaterialDepósito)

http:127.0.0.1:8080/api/entity/v1/grupoMateriaispontoAbast?codigo=2000

Observações-

  • É obrigatório informar os atributos que compõem a chave primária como parâmetros da chamada (atributos codigo ou pontoERP).
  • Caso o atributo pontoERP for informado e o atributo codigo não for informado na requisição, o ponto será localizado através do atributo pontoERP informado.