# Post Bulletin

Sends bulletins from the Roads module for import into the SGF.

Endpoint: POST /roads/bulletins
Version: v2
Security: API-Key, Client-Code

## Security:

  - `API-Key` (unknown)
    apiKey in header Authorization

  - `Client-Code` (unknown)
    apiKey in header Client-Code

## Request fields (application/json):

  - `managementUnit` (string | null, required)
    Management unit the bulletin belongs to.

  - `serialNumber` (string | null)
    Device serial number. Defaults to the client metadata value when omitted.

  - `userCode` (string | null)
    User code. Defaults to the client metadata value when omitted.

  - `fornecedor` (string | null)
    Supplier code. Optional.

  - `ctlImportSilvicultura` (array, required)
    Bulletins to send.

  - `ctlImportSilvicultura.cdEscalaRendimentoBol` (string | null)

  - `ctlImportSilvicultura.cdPadraoRendimentoBol` (string | null)

  - `ctlImportSilvicultura.cdUsuarioApontador` (string | null)

  - `ctlImportSilvicultura.cdFuncionarioEncarregado` (string | null)

  - `ctlImportSilvicultura.cdFuncionarioAjudante` (string | null)

  - `ctlImportSilvicultura.flagFechamentoTalhao` (string | null)

  - `ctlImportSilvicultura.refBoletimSilvDispositivo` (string | null)

  - `ctlImportSilvicultura.cdUnidadeBol` (string | null)

  - `ctlImportSilvicultura.dcrSerialDispositivoApontador` (string | null)

  - `ctlImportSilvicultura.cdMotivoDescarteMuda` (string | null)

  - `ctlImportSilvicultura.cdEspacamento` (string | null)

  - `ctlImportSilvicultura.cdMaterialGenetico` (string | null)

  - `ctlImportSilvicultura.cdTurno` (string | null)

  - `ctlImportSilvicultura.cdEquipe` (string | null)

  - `ctlImportSilvicultura.cdOperacaoProgramada` (string | null)

  - `ctlImportSilvicultura.dataOperacao` (string | null)

  - `ctlImportSilvicultura.vlrProducao` (string | null)

  - `ctlImportSilvicultura.dcrObservacao` (string | null)

  - `ctlImportSilvicultura.versionCode` (string | null)

  - `ctlImportSilvicultura.deviceName` (string | null)

  - `ctlImportSilvicultura.dataCancelamento` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv` (array, required)
    Bulletin resources.

  - `ctlImportSilvicultura.ctlImportRecursoSilv.cdParada` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.cdPadraoRendimentoRec` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.cdUnidadeRec` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.numTotalHorimetro` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.cdEscalaRendimentoRec` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.dcrObservacaoRec` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.cdClasseRendimentoRec` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.flagTipoRecurso` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.cdRecurso` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.qtdProducao` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.cdEquipamento` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.dataHoraIni` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.dataHoraFim` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.numTotalHoras` (string | null)

  - `ctlImportSilvicultura.ctlImportRecursoSilv.cdMotorista` (string | null)

  - `ctlImportSilvicultura.ctlImportUsoSolo` (array)
    Bulletin land uses.

  - `ctlImportSilvicultura.ctlImportUsoSolo.cdUsoSolo` (string | null)

## Response 200:

  - `200` (unknown)
    Success.

## Response 200 fields (application/json):

  - `requestId` (string | null)

  - `status` (string)
    Request outcome. Open list: new values may be added; clients should tolerate unknown values.
    Enum: "success", "processing", "accepted", "bad_request", "unprocessable_entity", "error", "service_unavailable"

  - `message` (string)

  - `dados` (array)

  - `dados.refBoletimSilvDispositivo` (string)
    Bulletin reference on the device.

  - `errors` (object | null)
    Validation or rejection errors, per field (field -> list of messages). The `$` key identifies a rejection not tied to a specific field. It is null on technical failures.

## Response 202:

  - `202` (unknown)
    Your request is being processed.

## Response 202 fields (application/json):

  - `requestId` (string | null)

  - `status` (string)
    Request outcome. Open list: new values may be added; clients should tolerate unknown values.
    Enum: "success", "processing", "accepted", "bad_request", "unprocessable_entity", "error", "service_unavailable"

  - `message` (string)

  - `dados` (object | array | null)

  - `errors` (object | null)
    Validation or rejection errors, per field (field -> list of messages). The `$` key identifies a rejection not tied to a specific field. It is null on technical failures.

## Response 400 fields (application/json):

  - `requestId` (string | null)

  - `status` (string)
    Request outcome. Open list: new values may be added; clients should tolerate unknown values.
    Enum: "success", "processing", "accepted", "bad_request", "unprocessable_entity", "error", "service_unavailable"

  - `message` (string)

  - `dados` (object | array | null)

  - `errors` (object | null)
    Validation or rejection errors, per field (field -> list of messages). The `$` key identifies a rejection not tied to a specific field. It is null on technical failures.

## Response 401:

  - `401` (unknown)
    Unauthorized. It happens when the API Key sent does not pass authentication.

## Response 401 fields (application/json):

  - `error` (string)

## Response 403:

  - `403` (unknown)
    Forbidden. It happens when the API Key sent does not have access to the specified client.

## Response 403 fields (application/json):

  - `error` (string)

## Response 422:

  - `422` (unknown)
    The destination system rejected the request. The `errors` field details the reason per field; the `$` key indicates a rejection not tied to a specific field.

## Response 422 fields (application/json):

  - `requestId` (string | null)

  - `status` (string)
    Request outcome. Open list: new values may be added; clients should tolerate unknown values.
    Enum: "success", "processing", "accepted", "bad_request", "unprocessable_entity", "error", "service_unavailable"

  - `message` (string)

  - `dados` (object | array | null)

  - `errors` (object | null)
    Validation or rejection errors, per field (field -> list of messages). The `$` key identifies a rejection not tied to a specific field. It is null on technical failures.

## Response 500 fields (application/json):

  - `requestId` (string | null)

  - `status` (string)
    Request outcome. Open list: new values may be added; clients should tolerate unknown values.
    Enum: "success", "processing", "accepted", "bad_request", "unprocessable_entity", "error", "service_unavailable"

  - `message` (string)

  - `dados` (object | array | null)

  - `errors` (object | null)
    Validation or rejection errors, per field (field -> list of messages). The `$` key identifies a rejection not tied to a specific field. It is null on technical failures.

## Response 502:

  - `502` (unknown)
    The destination system returned an invalid response or could not be reached.

## Response 502 fields (application/json):

  - `requestId` (string | null)

  - `status` (string)
    Request outcome. Open list: new values may be added; clients should tolerate unknown values.
    Enum: "success", "processing", "accepted", "bad_request", "unprocessable_entity", "error", "service_unavailable"

  - `message` (string)

  - `dados` (object | array | null)

  - `errors` (object | null)
    Validation or rejection errors, per field (field -> list of messages). The `$` key identifies a rejection not tied to a specific field. It is null on technical failures.

## Response 503:

  - `503` (unknown)
    The destination system or the service is temporarily unavailable or at capacity. Retry after the interval indicated in the `Retry-After` header.

## Response 503 fields (application/json):

  - `requestId` (string | null)

  - `status` (string)
    Request outcome. Open list: new values may be added; clients should tolerate unknown values.
    Enum: "success", "processing", "accepted", "bad_request", "unprocessable_entity", "error", "service_unavailable"

  - `message` (string)

  - `dados` (object | array | null)

  - `errors` (object | null)
    Validation or rejection errors, per field (field -> list of messages). The `$` key identifies a rejection not tied to a specific field. It is null on technical failures.

## Response 503 headers (application/json):

  - `Retry-After` (integer)
    Time to wait, in seconds, before retrying.

## Response 504:

  - `504` (unknown)
    The destination system did not respond in time.

## Response 504 fields (application/json):

  - `requestId` (string | null)

  - `status` (string)
    Request outcome. Open list: new values may be added; clients should tolerate unknown values.
    Enum: "success", "processing", "accepted", "bad_request", "unprocessable_entity", "error", "service_unavailable"

  - `message` (string)

  - `dados` (object | array | null)

  - `errors` (object | null)
    Validation or rejection errors, per field (field -> list of messages). The `$` key identifies a rejection not tied to a specific field. It is null on technical failures.