RecebimentoController

Fase 06: Armazenamento - 15. Recebimento

Endpoint: /armazenamento/recebimento

method: POST

path: /armazenamento/recebimento

description: Endpoint para cadastrar

parameters:
  - name: entity
    type: CreateChainEntity
    description: Parâmetro entity
    required: true
    in: body

Exemplo de requisição:

curl --request POST \
  --url https://<url>/armazenamento/recebimento \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>' \
  -d '{
    "safraId": "<id_safra>",
    "safraCodigo": "<codigo_safra>",
    "dados": {

      "dataHoraRecebimento": "01-01-2022",
      "veiculo": "Veículo de transporte",
      "volume": "Volume recebido",
      "loteOrigem": "Lote de origem",
      "umidade": "Umidade",
      "impureza": "Impurezas",
      "tipoCafe": "Tipo de café (certificada/não-certificada, orgânica/convencional)"

    }
  }'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /armazenamento/recebimento

method: PUT

path: /armazenamento/recebimento

description: Endpoint para atualizar

parameters:
  - name: entity
    type: UpdateChainEntity
    description: Parâmetro entity
    required: true
    in: body

Exemplo de requisição:

curl --request PUT \
  --url https://<url>/armazenamento/recebimento \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>' \
  -d '{
    "safraId": "<id_safra>",
    "safraCodigo": "<codigo_safra>",
    "dados": {

      "dataHoraRecebimento": "01-01-2022",
      "veiculo": "Veículo de transporte",
      "volume": "Volume recebido",
      "loteOrigem": "Lote de origem",
      "umidade": "Umidade",
      "impureza": "Impurezas",
      "tipoCafe": "Tipo de café (certificada/não-certificada, orgânica/convencional)"

    }
  }'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /armazenamento/recebimento/{id}

method: GET

path: /armazenamento/recebimento/{id}

description: Endpoint para getById

parameters:
  - name: id
    type: String
    description: Parâmetro id
    required: true
    in: path

Exemplo de requisição:

curl --request GET \
  --url https://<url>/armazenamento/recebimento/{id} \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /armazenamento/recebimento/safra/{id}

method: GET

path: /armazenamento/recebimento/safra/{id}

description: Endpoint para getBySafra

parameters:
  - name: id
    type: String
    description: Parâmetro id
    required: true
    in: path

Exemplo de requisição:

curl --request GET \
  --url https://<url>/armazenamento/recebimento/safra/{id} \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /armazenamento/recebimento

method: GET

path: /armazenamento/recebimento

description: Endpoint para listar

parameters:
  - name: =
    type: (size
    description: Parâmetro =
    required: false
    in: query
  - name: =
    type: sort
    description: Parâmetro =
    required: false
    in: query

Exemplo de requisição:

curl --request GET \
  --url https://<url>/armazenamento/recebimento \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /armazenamento/recebimento/{id}

method: DELETE

path: /armazenamento/recebimento/{id}

description: Endpoint para excluir

parameters:
  - name: id
    type: String
    description: Parâmetro id
    required: true
    in: path

Exemplo de requisição:

curl --request DELETE \
  --url https://<url>/armazenamento/recebimento/{id} \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}