Postman — Endpoints Simplificados¶

Este documento contém exemplos de requisições para uso nos endpoints simplificados do SISBOV. Para importar a coleção completa, utilize o arquivo SISBOV Dummy 2.0.postman_collection.json localizado na raiz do diretório api-documentacao.

ANIMAL¶

GET Buscar Animal por Número¶

Retorna um animal usando seu número de rastreabilidade (chave natural).

Method: GET
URL: {{base_url}}/animal/{{numero_animal}}/getAnimalPorNumero
Authorization: Bearer Token → {{token}}

Variáveis de ambiente utilizadas:

Variável	Descrição	Exemplo
`base_url`	URL base da API de integração	`https://api.sisbov.agr.br`
`token`	Token JWT de autenticação	`eyJhbGciOiJ...`
`numero_animal`	Número de rastreabilidade do animal	`123456789`

Resposta esperada (200 - OK):

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "numero": "123456",
  "sexo": "MA",
  "codigoRaca": "01",
  "dataNascimento": "2022-05-10"
}

Resposta de erro (404 - Not Found):

{
  "message": "Animal não localizado: 123456789"
}

PUT Atualizar Animal por Número¶

Atualiza um animal usando seu número de rastreabilidade (chave natural).

Method: PUT
URL: {{base_url}}/animal/{{numero_animal}}/atualizarAnimalPorNumero
Authorization: Bearer Token → {{token}}
Content-Type: application/json

Body (raw JSON):

{
  "sexo": "MA",
  "codigoRaca": "01",
  "dataNascimento": "2022-05-10",
  "dataIdentificacao": "2022-06-01"
}

Variáveis de ambiente utilizadas:

Variável	Descrição	Exemplo
`base_url`	URL base da API de integração	`https://api.sisbov.agr.br`
`token`	Token JWT de autenticação	`eyJhbGciOiJ...`
`numero_animal`	Número de rastreabilidade do animal	`123456789`

Resposta esperada (201 - Created):

{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Resposta de erro (404 - Not Found):

{
  "message": "Animal não localizado: 123456789"
}

GET Buscar Animal por Número¶

Method: GET
URL: {{base_url}}/animal/{{numero_animal}}/getAnimalPorNumero
Authorization: Bearer Token → {{token}}

GET Consulta Simplificada por Número¶

Method: GET
URL: {{base_url}}/animal/{{numero_animal}}/consultaSimplificadaPorNumero/{{status}}
Authorization: Bearer Token → {{token}}

Valores válidos para status: ATIVO, INATIVO, etc.

PUT Solicitação de Alteração de Posse por Identificador¶

Method: PUT
URL: {{base_url}}/animal/registraSolicitacaoAlteracaoDePossePorIdentificador/{{identificador_produtor_destino}}
Authorization: Bearer Token → {{token}}
Content-Type: application/json

Body:

["111111", "222222", "333333"]

PUT Registrar Desligamento por Número¶

Method: PUT
URL: {{base_url}}/animal/{{numero_animal}}/registraDesligamentoPorNumero/{{id_tipo_desligamento}}?dataDesligamento=2024-01-15
Authorization: Bearer Token → {{token}}

PUT Registrar Religamento por Número¶

Method: PUT
URL: {{base_url}}/animal/{{numero_animal}}/registraReligamentoPorNumero
Authorization: Bearer Token → {{token}}

PUT Registrar Morte por Número¶

Method: PUT
URL: {{base_url}}/animal/{{numero_animal}}/registraMortePorNumero/{{id_causa_morte}}/{{data_morte}}
Authorization: Bearer Token → {{token}}

PUT Cancelar Morte por Número¶

Method: PUT
URL: {{base_url}}/animal/{{numero_animal}}/cancelarMortePorNumero
Authorization: Bearer Token → {{token}}

PROPRIEDADE — Exemplos Postman¶

PUT putPropriedadePorCodigoEras - Method: PUT - URL: {{base_url}}/propriedade/12345/putPropriedadePorCodigoEras - Headers: Authorization: Bearer {{token}}, Content-Type: application/json - Body: {"nome": "Fazenda Exemplo"}

GET getPropriedadePorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/getPropriedadePorCodigoEras - Headers: Authorization: Bearer {{token}}

PUT novoEnderecoPorCodigoEras - Method: PUT - URL: {{base_url}}/propriedade/12345/novoEnderecoPorCodigoEras - Headers: Authorization: Bearer {{token}}, Content-Type: application/json - Body: {"logradouro": "Rod. BR-050", "municipio": "Uberaba", "uf": "MG"}

PUT vincularProdutorPorCodigoEras - Method: PUT - URL: {{base_url}}/propriedade/12345/vincularProdutorPorCodigoEras/12345678000195 - Headers: Authorization: Bearer {{token}}

PUT desvincularProdutorPorCodigoEras - Method: PUT - URL: {{base_url}}/propriedade/12345/desvincularProdutorPorCodigoEras/12345678000195 - Headers: Authorization: Bearer {{token}}

GET listResumoAnimaisPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/listResumoAnimaisPorCodigoEras - Headers: Authorization: Bearer {{token}}

GET listaAnimaisStatusPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/listaAnimaisStatusPorCodigoEras/ATIVO?pageSize=10&currentPage=0 - Headers: Authorization: Bearer {{token}}

GET countAnimaisStatusPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/countAnimaisStatusPorCodigoEras/ATIVO - Headers: Authorization: Bearer {{token}}

GET listaAnimaisVivosPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/listaAnimaisVivosPorCodigoEras?pageSize=10&currentPage=0 - Headers: Authorization: Bearer {{token}}

GET countAnimaisVivosPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/countAnimaisVivosPorCodigoEras - Headers: Authorization: Bearer {{token}}

GET getProdutoresVinculadosPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/getProdutoresVinculadosPorCodigoEras?pageSize=10&currentPage=0 - Headers: Authorization: Bearer {{token}}

GET getProprietariosVinculadosPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/getProprietariosVinculadosPorCodigoEras?pageSize=10&currentPage=0 - Headers: Authorization: Bearer {{token}}

PUT vincularProprietarioPorCodigoEras - Method: PUT - URL: {{base_url}}/propriedade/12345/vincularProprietarioPorCodigoEras/12345678900 - Headers: Authorization: Bearer {{token}}

PUT desvincularProprietarioPorCodigoEras - Method: PUT - URL: {{base_url}}/propriedade/12345/desvincularProprietarioPorCodigoEras/12345678900 - Headers: Authorization: Bearer {{token}}

GET historicoPropriedadeProdutoresVinculadosPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/historicoPropriedadeProdutoresVinculadosPorCodigoEras - Headers: Authorization: Bearer {{token}}

GET historicoProprietarioPropriedadePorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/historicoProprietarioPropriedadePorCodigoEras - Headers: Authorization: Bearer {{token}}

POST criarSuspensaoPorCodigoEras - Method: POST - URL: {{base_url}}/propriedade/12345/criarSuspensaoPorCodigoEras - Headers: Authorization: Bearer {{token}}, Content-Type: application/json - Body: {"motivo": "Irregularidade sanitária", "dataInicio": "2024-01-01"}

GET listarSuspensoesPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/listarSuspensoesPorCodigoEras - Headers: Authorization: Bearer {{token}}

GET listarConfinamentosPorCodigoEras - Method: GET - URL: {{base_url}}/propriedade/12345/listarConfinamentosPorCodigoEras - Headers: Authorization: Bearer {{token}}

POST cadastrarConfinamentoPorCodigoEras - Method: POST - URL: {{base_url}}/propriedade/12345/cadastrarConfinamentoPorCodigoEras - Headers: Authorization: Bearer {{token}}, Content-Type: application/json - Body: {"dataInicial": "2024-01-01", "dataFinal": "2024-03-31"}

PROPRIETÁRIO — Exemplos Postman¶

PUT putProprietarioPorIdentificador - Method: PUT - URL: {{base_url}}/proprietario/12345678000195/putProprietarioPorIdentificador - Headers: Authorization: Bearer {{token}}, Content-Type: application/json - Body: {"nome": "João Silva"}

GET getProprietarioPorIdentificador - Method: GET - URL: {{base_url}}/proprietario/12345678000195/getProprietarioPorIdentificador - Headers: Authorization: Bearer {{token}}

PUT novoEnderecoProprietarioPorIdentificador - Method: PUT - URL: {{base_url}}/proprietario/12345678000195/novoEnderecoProprietarioPorIdentificador - Headers: Authorization: Bearer {{token}}, Content-Type: application/json - Body: {"logradouro": "Rua X", "municipio": "São Paulo", "uf": "SP"}

PUT vincularPropriedadePorIdentificadores - Method: PUT - URL: {{base_url}}/proprietario/12345678000195/vincularPropriedadePorIdentificadores/12345 - Headers: Authorization: Bearer {{token}}

GET getPropriedadesVinculadasPorIdentificador - Method: GET - URL: {{base_url}}/proprietario/12345678000195/getPropriedadesVinculadasPorIdentificador?pageSize=10&currentPage=0 - Headers: Authorization: Bearer {{token}}