Upload de documentos
curl --request POST \
--url https://api.example.com/contract/documents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "<string>",
"cpf": "<string>",
"contract": "<string>"
}
'import requests
url = "https://api.example.com/contract/documents"
payload = {
"type": "<string>",
"cpf": "<string>",
"contract": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({type: '<string>', cpf: '<string>', contract: '<string>'})
};
fetch('https://api.example.com/contract/documents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Contratação Ativa
Upload de documentos
Envio da CCB assinada, documento de identidade e biometria após a formalização
POST
/
contract
/
documents
Upload de documentos
curl --request POST \
--url https://api.example.com/contract/documents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "<string>",
"cpf": "<string>",
"contract": "<string>"
}
'import requests
url = "https://api.example.com/contract/documents"
payload = {
"type": "<string>",
"cpf": "<string>",
"contract": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({type: '<string>', cpf: '<string>', contract: '<string>'})
};
fetch('https://api.example.com/contract/documents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Etapa condicional — obrigatória apenas quando a formalização é conduzida pela solução do contratante.
Todos os endpoints requerem autenticação via Bearer token no header
Authorization.
Consulte o guia de autenticação para obter suas credenciais e gerar um token.POST /contract/documents · multipart/form-data
Parâmetros
file
required
Arquivo do documento (campo multipart
file)string
required
Tipo do documento
string
required
CPF do trabalhador — 8 a 11 dígitos numéricos
string
required
Identificador do contrato — 13 a 15 caracteres alfanuméricos
Exemplo
cURL
curl -X POST https://hml.zipdin.com.br/dataprev-controller/contract/documents \
-H "x-api-key: SUA_API_KEY" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "x-idempotency-key: 3f8a91b2-7c4d-4e5f-a6b7-8c9d0e1f2a3b" \
-F "file=@ccb-assinada.pdf" \
-F "type=CCB" \
-F "cpf=52998224725" \
-F "contract=CTR20260520001"
Erros
Este endpoint usa o formato RFC7807-like (não o formato achatado dos endpointsworker-*) — veja
Averbação → Erros de /contract/*.
400 - Exemplo
{
"error": {
"type": null,
"title": "Validation failed",
"detail": null,
"instance": "/dataprev-controller/contract/documents",
"status": 400,
"errors": [{ "field": "contract", "message": "Contrato deve ter entre 13 e 15 caracteres" }]
}
}
