Neste site demonstramos as funcionalidades da API WXEQ, dentre elas, autenticação, paginação, consulta com filtro, inserção e alteração de dados.
O resultado da busca conterá no seu cabeçalho:
X-Pagination-Total-Count: Total de registrosX-Pagination-Page-Count: Total de páginasX-Pagination-Current-Page: Índice da página atualX-Pagination-Per-Page: Quantidade de registros por páginaÉ possível definir qual o índice da página e quantidade de registros por página devem ser retornandos.
page: Índice da páginaper-page: Quantidade de registros por páginaExemplo:
http://api.wxeq.com.br/v1/trajeto?page=2&per-page=30
Em todas as requisições de listagem de dados é possível definir um filtro
{
"or": [
{
"and": [
{"descricao": "alguma descricao"},
{"preco": 25.50}
]
}, {
"id": {"in": [2, 5, 9]},
"preco": {"gt": 10, "lt": 50}
}
]
}
Os possíveis operadores são:
lt: <gt: >lte: <=gte: >=eq: =neq: diferentein: contidonin: não está contidolike: contendoExemplo:
http://api.wxeq.com.br/v1/trajeto?filtro={"id": {"in": [1]}}
Em todas as requisições de listagem de dados é possível definir uma totalização sumário
[{
selector: "numero",
summaryType: "count"
},
{
selector: "qtd",
summaryType: "sum"
}]
Exemplo:
http://api.wxeq.com.br/v1/trajeto?totalSummary=[{selector: "numero",summaryType: "count"}]
Obtem informações do login.
No retorno conterá o campo token que deverá ser utilizado nas demais requisições como método de autenticação.
Os seguintes métodos de autenticação estão disponíveis:
Authentication com o valor Jwt <TOKEN>)Todas requisições deverão conter o token utilizando um método de autenticação
| username required | string Email de acesso |
| password required | string Senha de acesso |
{- "success": true,
- "message": "Login bem-sucedido, salve seu token",
- "data": {
- "id": "1,",
- "token": "token-exemplo",
- "email": "email@wxeq.com.br",
- "login": "wxeq",
- "nome": "WXEQ Tecnologia",
- "apps": {
- "maps": {
- "host": "null",
- "port": "null",
- "proxy": false
}
}
}
}| page | integer Verificar documentação da paginação |
| per-page | integer Verificar documentação da paginação |
| filtro | string Verificar documentação do filtro |
| summary | string Verificar documentação dos sumário |
{- "success": true,
- "data": [
- {
- "id": "63901",
- "numero": 3515,
- "transportador_id": "21804",
- "datexpedicao": "2021-07-12",
- "entidade_id": null,
- "entidade_id2": null,
- "entidade_id3": null,
- "motorista_id": null,
- "checklist": 1,
- "status": 1,
- "nf": null,
- "ctrc": null,
- "problema": null,
- "observacao": null,
- "datcadastro": "2021-07-05 17:20",
- "datalteracao": "2021-07-05 17:20",
- "tenant_id": "21702",
- "datinicio": null,
- "modelo": null,
- "motorista_id2": null,
- "origem_id": "3566",
- "pontuacao_coleta": null,
- "pontuacao_entrega": null,
- "pontuacao_qualidade": null,
- "produto_id": null,
- "datnf": null,
- "datctrc": null,
- "pedido": null,
- "pedido2": null,
- "tipofrete": null,
- "balanca": null,
- "balanca2": null,
- "tanque_id": null,
- "pessoa_etapa_id": "133",
- "chave_checklist": null,
- "tipo": 1,
- "plataforma_id": null,
- "ordem": null,
- "balanca_liquido": null,
- "projeto": null,
- "unidade_id": null,
- "integrado": 0,
- "vinculo": null,
- "ficha": null,
- "datbalanca": null,
- "datbalanca2": null,
- "obs_atividade": null,
- "acessorios": null,
- "conteudo": null,
- "contrato_tempo": null,
- "tipo_entidade_id": null,
- "numero_transporte": null,
- "datjanela": "2021-07-05 00:00",
- "coleta_id": null,
- "tipo_servico_id": null,
- "etapa_id": 1,
- "entregas": [
- {
- "id": "69845",
- "trajeto_id": "63901",
- "cliente_id": "21702",
- "produto_id": "671",
- "itens": null,
- "itens_unidademed_id": null,
- "peso": null,
- "peso_unidademed_id": null,
- "datentrega": "2021-07-14 18:00",
- "datbaixa": null,
- "canhoto": null,
- "tenant_id": "21702",
- "avaria": null,
- "observacao": null,
- "observacao_alterar": null,
- "produto_obs": null,
- "endereco_id": null,
- "datchegada": null,
- "pontuacao_qualidade": null,
- "pontuacao_pontualidade": null,
- "cliente_origem_id": null
}
]
}
]
}{- "sucesso": true,
- "conteudo": {
- "id": 63901,
- "numero": 3515,
- "transportador_id": "21804",
- "datexpedicao": "2021-07-12",
- "entidade_id": null,
- "entidade_id2": null,
- "entidade_id3": null,
- "motorista_id": null,
- "checklist": 1,
- "status": 1,
- "nf": null,
- "ctrc": null,
- "problema": null,
- "observacao": null,
- "datcadastro": "2021-07-05 17:20",
- "datalteracao": "2021-07-05 17:20",
- "tenant_id": "21702",
- "datinicio": null,
- "modelo": null,
- "motorista_id2": null,
- "origem_id": "3566",
- "pontuacao_coleta": null,
- "pontuacao_entrega": null,
- "pontuacao_qualidade": null,
- "produto_id": null,
- "datnf": null,
- "datctrc": null,
- "pedido": null,
- "pedido2": null,
- "tipofrete": null,
- "balanca": null,
- "balanca2": null,
- "tanque_id": null,
- "pessoa_etapa_id": "133",
- "chave_checklist": null,
- "tipo": 1,
- "plataforma_id": null,
- "ordem": null,
- "balanca_liquido": null,
- "projeto": null,
- "unidade_id": null,
- "integrado": 0,
- "vinculo": null,
- "ficha": null,
- "datbalanca": null,
- "datbalanca2": null,
- "obs_atividade": null,
- "acessorios": null,
- "conteudo": null,
- "contrato_tempo": null,
- "tipo_entidade_id": null,
- "numero_transporte": null,
- "datjanela": "2021-07-05 00:00",
- "coleta_id": null,
- "tipo_servico_id": null,
- "etapa_id": 1,
- "entregas": [
- {
- "id": 69845,
- "trajeto_id": 63901,
- "cliente_id": 21702,
- "produto_id": 671,
- "itens": null,
- "itens_unidademed_id": null,
- "peso": null,
- "peso_unidademed_id": null,
- "datentrega": "2021-07-14 18:00",
- "datbaixa": null,
- "canhoto": null,
- "tenant_id": "21702",
- "avaria": null,
- "observacao": null,
- "observacao_alterar": null,
- "produto_obs": null,
- "endereco_id": null,
- "datchegada": null,
- "pontuacao_qualidade": null,
- "pontuacao_pontualidade": null,
- "cliente_origem_id": null
}
]
}
}| id required | string Identificador único |
| etapa_id required | integer Etapa atual do trajeto, informação contida no retorno do trajeto |
| numero | string |
| datexpedicao required | string |
| datjanela | string |
| transportador_id required | integer |
| entidade_id | integer |
| entidade_id2 | integer |
| entidade_id3 | integer |
| motorista_id | integer |
| motorista_id2 | integer |
| origem_id required | integer |
| coleta_id | integer |
| plataforma_id | integer |
| unidade_id | integer |
| tipo_entidade_id | integer |
| numero_transporte | string |
| nf | string |
| datnf | string |
| ctrc | string |
| datctrc | string |
| balanca | number |
| balanca2 | number |
| balanca_liquido | number |
| etapa_id | number Parâmetro obrigatório para avançar etapa |
Array of objects (schemas) | |
Array of objects (schemas) |
{- "numero": "string",
- "datexpedicao": "string",
- "datjanela": "string",
- "transportador_id": 0,
- "entidade_id": 0,
- "entidade_id2": 0,
- "entidade_id3": 0,
- "motorista_id": 0,
- "motorista_id2": 0,
- "origem_id": 0,
- "coleta_id": 0,
- "plataforma_id": 0,
- "unidade_id": 0,
- "tipo_entidade_id": 0,
- "numero_transporte": "string",
- "nf": "string",
- "datnf": "string",
- "ctrc": "string",
- "datctrc": "string",
- "balanca": 0,
- "balanca2": 0,
- "balanca_liquido": 0,
- "etapa_id": 0,
- "entregas": [
- {
- "cliente_id": 0,
- "produto_id": 0,
- "itens_unidademed_id": 0,
- "peso_unidademed_id": 0,
- "endereco_id": 0,
- "cliente_origem_id": 0,
- "avaria": true,
- "datentrega": "string",
- "datbaixa": "string",
- "datchegada": "string",
- "canhoto": "string"
}
], - "status": [
- {
- "trajeto_id": 0,
- "status": 0,
- "sequencia": 0,
- "checklist_id": 0,
- "usuario_id": 0,
- "pessoa_etapa_id": 0,
- "observacao": "string"
}
]
}{- "sucesso": true,
- "conteudo": {
- "id": 63901,
- "numero": 3515,
- "transportador_id": "21804",
- "datexpedicao": "2021-07-12",
- "entidade_id": null,
- "entidade_id2": null,
- "entidade_id3": null,
- "motorista_id": null,
- "checklist": 1,
- "status": 1,
- "nf": null,
- "ctrc": null,
- "problema": null,
- "observacao": null,
- "datcadastro": "2021-07-05 17:20",
- "datalteracao": "2021-07-05 17:20",
- "tenant_id": "21702",
- "datinicio": null,
- "modelo": null,
- "motorista_id2": null,
- "origem_id": "3566",
- "pontuacao_coleta": null,
- "pontuacao_entrega": null,
- "pontuacao_qualidade": null,
- "produto_id": null,
- "datnf": null,
- "datctrc": null,
- "pedido": null,
- "pedido2": null,
- "tipofrete": null,
- "balanca": null,
- "balanca2": null,
- "tanque_id": null,
- "pessoa_etapa_id": "133",
- "chave_checklist": null,
- "tipo": 1,
- "plataforma_id": null,
- "ordem": null,
- "balanca_liquido": null,
- "projeto": null,
- "unidade_id": null,
- "integrado": 0,
- "vinculo": null,
- "ficha": null,
- "datbalanca": null,
- "datbalanca2": null,
- "obs_atividade": null,
- "acessorios": null,
- "conteudo": null,
- "contrato_tempo": null,
- "tipo_entidade_id": null,
- "numero_transporte": null,
- "datjanela": "2021-07-05 00:00",
- "coleta_id": null,
- "tipo_servico_id": null,
- "etapa_id": 1,
- "entregas": [
- {
- "id": 69845,
- "trajeto_id": 63901,
- "cliente_id": 21702,
- "produto_id": 671,
- "itens": null,
- "itens_unidademed_id": null,
- "peso": null,
- "peso_unidademed_id": null,
- "datentrega": "2021-07-14 18:00",
- "datbaixa": null,
- "canhoto": null,
- "tenant_id": "21702",
- "avaria": null,
- "observacao": null,
- "observacao_alterar": null,
- "produto_obs": null,
- "endereco_id": null,
- "datchegada": null,
- "pontuacao_qualidade": null,
- "pontuacao_pontualidade": null,
- "cliente_origem_id": null
}
]
}
}| id required | string Identificador único |
| comunicar required | string Enviar email ao cancelar trajeto |
| justificativa | string |
{- "justificativa": "string"
}{- "sucesso": true,
- "conteudo": {
- "id": 63901,
- "numero": 3515,
- "transportador_id": "21804",
- "datexpedicao": "2021-07-12",
- "entidade_id": null,
- "entidade_id2": null,
- "entidade_id3": null,
- "motorista_id": null,
- "checklist": 1,
- "status": 1,
- "nf": null,
- "ctrc": null,
- "problema": null,
- "observacao": null,
- "datcadastro": "2021-07-05 17:20",
- "datalteracao": "2021-07-05 17:20",
- "tenant_id": "21702",
- "datinicio": null,
- "modelo": null,
- "motorista_id2": null,
- "origem_id": "3566",
- "pontuacao_coleta": null,
- "pontuacao_entrega": null,
- "pontuacao_qualidade": null,
- "produto_id": null,
- "datnf": null,
- "datctrc": null,
- "pedido": null,
- "pedido2": null,
- "tipofrete": null,
- "balanca": null,
- "balanca2": null,
- "tanque_id": null,
- "pessoa_etapa_id": "133",
- "chave_checklist": null,
- "tipo": 1,
- "plataforma_id": null,
- "ordem": null,
- "balanca_liquido": null,
- "projeto": null,
- "unidade_id": null,
- "integrado": 0,
- "vinculo": null,
- "ficha": null,
- "datbalanca": null,
- "datbalanca2": null,
- "obs_atividade": null,
- "acessorios": null,
- "conteudo": null,
- "contrato_tempo": null,
- "tipo_entidade_id": null,
- "numero_transporte": null,
- "datjanela": "2021-07-05 00:00",
- "coleta_id": null,
- "tipo_servico_id": null,
- "etapa_id": 1,
- "entregas": [
- {
- "id": 69845,
- "trajeto_id": 63901,
- "cliente_id": 21702,
- "produto_id": 671,
- "itens": null,
- "itens_unidademed_id": null,
- "peso": null,
- "peso_unidademed_id": null,
- "datentrega": "2021-07-14 18:00",
- "datbaixa": null,
- "canhoto": null,
- "tenant_id": "21702",
- "avaria": null,
- "observacao": null,
- "observacao_alterar": null,
- "produto_obs": null,
- "endereco_id": null,
- "datchegada": null,
- "pontuacao_qualidade": null,
- "pontuacao_pontualidade": null,
- "cliente_origem_id": null
}
]
}
}| id required | string Identificador único |
| comunicar required | string Enviar email ao cancelar trajeto |
{- "sucesso": true,
- "conteudo": {
- "id": 63901,
- "numero": 3515,
- "transportador_id": "21804",
- "datexpedicao": "2021-07-12",
- "entidade_id": null,
- "entidade_id2": null,
- "entidade_id3": null,
- "motorista_id": null,
- "checklist": 1,
- "status": 1,
- "nf": null,
- "ctrc": null,
- "problema": null,
- "observacao": null,
- "datcadastro": "2021-07-05 17:20",
- "datalteracao": "2021-07-05 17:20",
- "tenant_id": "21702",
- "datinicio": null,
- "modelo": null,
- "motorista_id2": null,
- "origem_id": "3566",
- "pontuacao_coleta": null,
- "pontuacao_entrega": null,
- "pontuacao_qualidade": null,
- "produto_id": null,
- "datnf": null,
- "datctrc": null,
- "pedido": null,
- "pedido2": null,
- "tipofrete": null,
- "balanca": null,
- "balanca2": null,
- "tanque_id": null,
- "pessoa_etapa_id": "133",
- "chave_checklist": null,
- "tipo": 1,
- "plataforma_id": null,
- "ordem": null,
- "balanca_liquido": null,
- "projeto": null,
- "unidade_id": null,
- "integrado": 0,
- "vinculo": null,
- "ficha": null,
- "datbalanca": null,
- "datbalanca2": null,
- "obs_atividade": null,
- "acessorios": null,
- "conteudo": null,
- "contrato_tempo": null,
- "tipo_entidade_id": null,
- "numero_transporte": null,
- "datjanela": "2021-07-05 00:00",
- "coleta_id": null,
- "tipo_servico_id": null,
- "etapa_id": 1,
- "entregas": [
- {
- "id": 69845,
- "trajeto_id": 63901,
- "cliente_id": 21702,
- "produto_id": 671,
- "itens": null,
- "itens_unidademed_id": null,
- "peso": null,
- "peso_unidademed_id": null,
- "datentrega": "2021-07-14 18:00",
- "datbaixa": null,
- "canhoto": null,
- "tenant_id": "21702",
- "avaria": null,
- "observacao": null,
- "observacao_alterar": null,
- "produto_obs": null,
- "endereco_id": null,
- "datchegada": null,
- "pontuacao_qualidade": null,
- "pontuacao_pontualidade": null,
- "cliente_origem_id": null
}
]
}
}| page | integer Verificar documentação da paginação |
| per-page | integer Verificar documentação da paginação |
| filtro | string Verificar documentação do filtro |
| summary | string Verificar documentação dos sumário |
{- "success": true,
- "data": [
- {
- "id": "474",
- "descricao": "MECÂNICO - FROTA PRÓPRIA",
- "produto_id": null,
- "tempo_minimo": 600,
- "tempo_maximo": 1800,
- "qtd_reprovar": null,
- "rank_reprovar": null,
- "seq_cabecalho": null,
- "ident_descricao": null,
- "ident_mascara": null,
- "ativo": 1,
- "datcadastro": "2018-05-01 14:34:26",
- "datalteracao": "2022-03-17 20:08:47",
- "tenant_id": "8474",
- "adicional": 0,
- "cadastros": 1,
- "statusemail": 2,
- "email": "",
- "cabecalho": "",
- "rodape": "",
- "titulo": "",
- "cadastrooc": 0,
- "marcacao": 0,
- "tipoinicio": 3,
- "diasvalidade": null,
- "notificacao_conteudo": "",
- "notificacao_tempo": null,
- "agrupador": "OFICINA",
- "avaliacao": 1,
- "checklistItems": null,
- "proprietario": {
- "id": "1",
- "nome": "EMPRESA TESTE",
- "fantasia": "EMPRESA TESTE",
- "logomarca": null
}
}
]
}| page | integer Verificar documentação da paginação |
| per-page | integer Verificar documentação da paginação |
| filtro | string Verificar documentação do filtro |
| summary | string Verificar documentação dos sumário |
{- "success": true,
- "data": [
- {
- "id": "36534",
- "entidade_id": "10924",
- "entidade_id2": "10814",
- "entidade_id3": null,
- "pessoa_id": "8484",
- "checklist_id": "474",
- "checklist_status_id": "2",
- "latitude": "-12.87684960",
- "longitude": "-38.42328570",
- "datinicio": "2018-05-12 16:01:40",
- "datfim": "2018-05-12 16:02:49",
- "datcadastro": "2018-05-12 16:01",
- "datalteracao": "2018-05-12 14:01:40",
- "usuario_id": "9134",
- "tenant_id": "8474",
- "entidade_id4": null,
- "identificador": null,
- "info": null,
- "datvalidade": null,
- "nota": null,
- "timezone": null,
- "observacao": null,
- "items": [
- {
- "id": "709084",
- "checklist_mov_id": "36534",
- "checklist_item_id": "19944",
- "valor": "true",
- "data": null,
- "usa": 1,
- "datinicio": "2018-05-12 14:02:05",
- "datfim": "2018-05-12 14:02:06",
- "datcadastro": "2018-05-12 14:01:40",
- "datalteracao": "2018-05-12 14:01:40",
- "usuario_id": "9134",
- "peso": null,
- "nota": null,
- "resolvido": 0,
- "checklistItem": {
- "id": "19944",
- "checklist_id": "474",
- "tipo_controle_id": "1",
- "checklist_descricao_id": "2874",
- "mascara": "",
- "critico": 0,
- "rank": 0,
- "checklist_item_id": null,
- "detalhes": 3,
- "obrigatorio": 0,
- "sequencia": 1,
- "ativo": 0,
- "datcadastro": "2018-05-01 14:34:28",
- "datalteracao": "2021-05-12 18:27:19",
- "tenant_id": null,
- "naoaplica": 0,
- "classificacao": "",
- "cabecalho": 0,
- "detalhenao": 0,
- "valorseq": -1,
- "finalizarseq": 0,
- "checklist_item_seq_id": null,
- "agrupador": "Cavalo",
- "peso": null,
- "nota": null,
- "galeria": 0,
- "consulta": "",
- "checklistDescricao": {
- "id": "2874",
- "descricao": "POSSUI LAMEIRO EM BOAS CONDIÇÕES?",
- "ativo": 1,
- "tenant_id": "8474"
}, - "tipoControle": {
- "id": "1",
- "descricao": "Checkbox"
}, - "pai": null,
- "descricao": "POSSUI LAMEIRO EM BOAS CONDIÇÕES?",
- "checklist": {
- "id": "474",
- "nome": "MECÂNICO - FROTA PRÓPRIA"
}
}
}, - {
- "id": "708974",
- "checklist_mov_id": "36534",
- "checklist_item_id": "19834",
- "valor": "true",
- "data": null,
- "usa": 1,
- "datinicio": "2018-05-12 14:01:51",
- "datfim": "2018-05-12 14:01:53",
- "datcadastro": "2018-05-12 14:01:40",
- "datalteracao": "2018-05-12 14:01:40",
- "usuario_id": "9134",
- "peso": null,
- "nota": null,
- "resolvido": 0,
- "checklistItem": {
- "id": "19834",
- "checklist_id": "474",
- "tipo_controle_id": "1",
- "checklist_descricao_id": "2764",
- "mascara": "",
- "critico": 0,
- "rank": 0,
- "checklist_item_id": null,
- "detalhes": 3,
- "obrigatorio": 0,
- "sequencia": 2,
- "ativo": 1,
- "datcadastro": "2018-05-01 14:34:27",
- "datalteracao": "2021-07-14 17:06:23",
- "tenant_id": null,
- "naoaplica": 0,
- "classificacao": "1",
- "cabecalho": 0,
- "detalhenao": 0,
- "valorseq": -1,
- "finalizarseq": 0,
- "checklist_item_seq_id": null,
- "agrupador": "Motorista",
- "peso": null,
- "nota": null,
- "galeria": 0,
- "consulta": "",
- "checklistDescricao": {
- "id": "2764",
- "descricao": "ESTÁ DEVIDAMENTE FARDADO? (CALÇA, CAMISA POR DENTRO, CALÇADO DE SEGURANÇA, CINTO)?",
- "ativo": 1,
- "tenant_id": "8474"
}, - "tipoControle": {
- "id": "1",
- "descricao": "Checkbox"
}, - "pai": null,
- "descricao": "ESTÁ DEVIDAMENTE FARDADO? (CALÇA, CAMISA POR DENTRO, CALÇADO DE SEGURANÇA, CINTO)?",
- "checklist": {
- "id": "474",
- "nome": "MECÂNICO - FROTA PRÓPRIA"
}
}
}
]
}
]
}