Disparar obrigação de forma retroativa

POST

/api/v1/obrigacoes/entregas/{id}/enviar-retroativo

Última modificação:2026-02-24 18:28:37

Envia uma obrigação de forma retroativa, forçando o envio mesmo que esteja fora do período permitido ou vencida.

Diferenças do envio normal:

Não valida período de envio

Força envio mesmo se vencida

Status: ENVIADO_RETROATIVO

Template de e-mail recebe flag isRetroactive=true para adaptar texto

Parâmetros no body:

motivo (string, opcional): Motivo do disparo retroativo para auditoria

Validações:

A entrega deve ter arquivos anexados

O departamento deve ter e-mail configurado

Não permite enviar se já foi enviada (exceto FALHA_AO_ENVIAR)

Retorna: DTO da entrega atualizada com status ENVIADO_RETROATIVO.

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

Authorization: ********************

Parâmetros de Caminho

Parâmetros de Consulta

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200

*/*

Obrigação enviada retroativa com sucesso

Body

🟠400

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-homolog.docsend.com.br/api/v1/obrigacoes/entregas//enviar-retroativo?tenantId' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "motivo": "Cliente solicitou envio após vencimento"
}'

Response Example

200 - Exemplo 1

{
    "id": 0,
    "obrigacaoClienteId": 0,
    "periodoContabilId": 0,
    "ano": 0,
    "mes": 0,
    "dataVencimento": "2019-08-24",
    "dataEnvio": "2019-08-24T14:15:22.123Z",
    "status": "AGUARDANDO_ENVIO",
    "observacoes": "string",
    "tenantId": 0,
    "createdAt": "2019-08-24T14:15:22.123Z",
    "updatedAt": "2019-08-24T14:15:22.123Z",
    "obrigacaoNome": "string",
    "clienteNome": "string",
    "departamentoNome": "string",
    "responsavelId": 0,
    "responsavelNome": "string",
    "competenciaCalculada": "2019-08-24",
    "competenciaFormatada": "string",
    "arquivoIds": [
        0
    ],
    "documentoAnexado": true,
    "arquivos": [
        {
            "id": 0,
            "nome": "string",
            "urlVisualizacao": "string"
        }
    ]
}

Modificado em 2026-02-24 18:28:37