Vincular várias empresas a uma obrigação em massa

POST

/api/v1/obrigacoes/clientes/obrigacoes/{obrigacaoId}/empresas/bulk

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

Vincula em massa empresas a uma obrigação conforme o critério escolhido.

Tipos (tipo):

EMPRESAS: envia clienteIds (lista de IDs). Opcionalmente responsavelId para todas.

REGIMES: envia regimeTributarioIds (IDs dos regimes). Vincula a todas as empresas do tenant nesses regimes.

ESTADOS: envia estados (lista de UFs). Vincula a todas as empresas do tenant nesses estados.

REGIOES: envia regioes (Norte, Nordeste, Sul, Sudeste, Centro-Oeste). Vincula a todas as empresas do tenant nessas regiões.

Retorno: Resumo com vinculados, ignorados (já vinculados) e erros de validação.

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/jsonNecessário

Examples

Respostas

🟢200

*/*

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-homolog.docsend.com.br/api/v1/obrigacoes/clientes/obrigacoes//empresas/bulk?tenantId' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tipo": "EMPRESAS",
    "clienteIds": [
        0
    ],
    "responsavelId": 0,
    "regimeTributarioIds": [
        0
    ],
    "estados": [
        "string"
    ],
    "regioes": [
        "string"
    ]
}'

Response Example

{
    "vinculados": 0,
    "ignorados": 0,
    "erros": [
        {
            "clienteId": 0,
            "mensagem": "string"
        }
    ]
}

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

Página anterior

Adicionar empresa a uma obrigação

Próxima página

Criar entregas para obrigação-cliente