idpath · stringObrigatórioRestrições
{
"type": "string"
}Parâmetros, estrutura de dados e respostas do contrato versionado.
/embarcador/solicitacoes-transporte/{id}/fiscal/sincronizarDescrições técnicas preservadas do contrato versionado. Exemplos de dados foram omitidos da cópia pública.
Sincroniza o estado fiscal (fiscal_status) da solicitação com um CteDraft autorizado pertencente ao Transportador Agregado responsável pela operação, validando emitente, ambiente fiscal (tp_amb), vínculo com a operação/NF-e da solicitação e evidência canônica SEFAZ (sefaz_protocol / cstat = 100 / authorized_at / status = authorized). Em caso de cte_timeout, nova tentativa exige evidência canônica de consulta prévia de status SEFAZ no CteDraft (nunca um booleano enviado pelo cliente).
operacao — Operação[
{
"oauth2": []
},
{
"chaveApi": []
}
]idpath · stringObrigatório{
"type": "string"
}Obrigatório
application/jsoncte_draft_idinteger | nullOpcionalID do CteDraft vinculado à operação e emitido pelo Transportador Agregado responsável.
fiscal_statusstring | nullOpcional"ready_for_cte" · "ready_for_cte_prefill" · "cte_prefilled" · "cte_issuing" · "cte_authorized" · "cte_rejected" · "cte_timeout" · nulloutcomestring | nullOpcional"ready_for_cte" · "issuing" · "cte_issuing" · "authorized" · "cte_authorized" · "rejected" · "cte_rejected" · "timeout" · "cte_timeout" · nullexpected_tp_ambinteger | nullOpcionalAmbiente fiscal SEFAZ esperado (1 = produção, 2 = homologação).
1 · 2 · null200 Resposta HTTPEstado fiscal sincronizado com evidência canônica
application/jsonsuccessbooleanOpcionaldataobjectOpcionalcommercial_resolutionobject | nullOpcional422 Resposta HTTPDocumento fiscal inexistente, de outra empresa/operação, ambiente fiscal incompatível ou sem evidência canônica SEFAZ
{
"tags": [
"Solicitações e Contratação de Transporte (Embarcador)"
],
"summary": "Sincronizar situação de emissão de CT-e da operação",
"description": "Sincroniza o estado fiscal (`fiscal_status`) da solicitação com um `CteDraft` autorizado pertencente ao Transportador Agregado responsável pela operação, validando emitente, ambiente fiscal (`tp_amb`), vínculo com a operação/NF-e da solicitação e evidência canônica SEFAZ (`sefaz_protocol` / `cstat = 100` / `authorized_at` / `status = authorized`). Em caso de `cte_timeout`, nova tentativa exige evidência canônica de consulta prévia de status SEFAZ no `CteDraft` (nunca um booleano enviado pelo cliente).\n",
"operationId": "sincronizarFiscalSolicitacaoTransporteEmbarcador",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"cte_draft_id": {
"type": [
"integer",
"null"
],
"description": "ID do `CteDraft` vinculado à operação e emitido pelo Transportador Agregado responsável."
},
"fiscal_status": {
"type": [
"string",
"null"
],
"enum": [
"ready_for_cte",
"ready_for_cte_prefill",
"cte_prefilled",
"cte_issuing",
"cte_authorized",
"cte_rejected",
"cte_timeout",
null
]
},
"outcome": {
"type": [
"string",
"null"
],
"enum": [
"ready_for_cte",
"issuing",
"cte_issuing",
"authorized",
"cte_authorized",
"rejected",
"cte_rejected",
"timeout",
"cte_timeout",
null
]
},
"expected_tp_amb": {
"type": [
"integer",
"null"
],
"enum": [
1,
2,
null
],
"description": "Ambiente fiscal SEFAZ esperado (`1` = produção, `2` = homologação)."
}
}
}
}
}
},
"responses": {
"200": {
"description": "Estado fiscal sincronizado com evidência canônica",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SolicitacaoTransporteResponse"
}
}
}
},
"404": {
"description": "Solicitação não encontrada",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Erro"
}
}
}
},
"422": {
"description": "Documento fiscal inexistente, de outra empresa/operação, ambiente fiscal incompatível ou sem evidência canônica SEFAZ",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Erro"
}
}
}
}
},
"x-fleetpay-scope": "operacao",
"x-fleetpay-module": "contratacao-direta",
"x-fleetpay-profiles": [
"embarcador",
"gestor",
"agregado_empresarial"
],
"method": "POST",
"path": "/embarcador/solicitacoes-transporte/{id}/fiscal/sincronizar"
}