Importação CSV
Cadastre lotes pequenos com resultado por linha e retentativas seguras.
Comece pelo modelo da API
Baixe o modelo autenticado da API ou a amostra sintética deste portal. As quatro colunas obrigatórias são ID_REFERENCIA_EXTERNA, USUARIO_NOME, USUARIO_NASCIMENTO e USUARIO_SEXO, preenchidas em cada linha. Aspas protegem nomes com vírgula. Metadados autorizados usam METADADOS.CHAVE_AUTORIZADA.
GET/contas/{CONTA}/pacientes/importar/modeloKIN_BASE_URL=https://api.exemplo.invalid
curl -X GET "$KIN_BASE_URL/v7/integracoes/contas/cta_0123456789abcdef0123456789abcdef/pacientes/importar/modelo" \
-H 'Authorization: Bearer <API_KEY>' \
-H 'X-Correlation-ID: INTEGRACAO-EXEMPLO-001'Codifique os bytes UTF-8
No Node.js: const CSV_BASE64 = Buffer.from(csv, "utf8").toString("base64"). No navegador: const bytes = new TextEncoder().encode(csv); const CSV_BASE64 = btoa(Array.from(bytes, b => String.fromCharCode(b)).join(""));. Não use btoa(csv) diretamente para nomes com acento. Envie {"CSV_BASE64":"<bytes UTF-8 em Base64>"} com Content-Type: application/json e Idempotency-Key.
POST/contas/{CONTA}/pacientes/importarKIN_BASE_URL=https://api.exemplo.invalid
curl -X POST "$KIN_BASE_URL/v7/integracoes/contas/cta_0123456789abcdef0123456789abcdef/pacientes/importar" \
-H 'Authorization: Bearer <API_KEY>' \
-H 'X-Correlation-ID: INTEGRACAO-EXEMPLO-001' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: INTEGRACAO-CADASTRO-001' \
--data '{
"CSV_BASE64": "SURfUkVGRVJFTkNJQV9FWFRFUk5BLFVTVUFSSU9fTk9NRSxVU1VBUklPX05BU0NJTUVOVE8sVVNVQVJJT19TRVhPCjAwMTU4LCJBbmEsIEV4ZW1wbG8iLDE5OTAtMDQtMTUsRgo="
}'Limites e resultado por linha
Até 100 registros e 128 KiB decodificados. O parser aceita até 24 colunas e 1000 caracteres por célula, BOM, CRLF/LF e aspas duplicadas. Estrutura ou cabeçalho inválidos rejeitam o arquivo inteiro; valores inválidos geram REJEITADO por linha. LINHA é a linha física inicial do registro, incluindo o cabeçalho.
Retome o mesmo lote
A importação é síncrona e somente de criação: referências existentes retornam JA_CADASTRADO sem sobrescrita. HTTP 200 significa lote processado, não sucesso de todas as linhas. Após timeout, preserve arquivo e chave para retomar resultados confirmados. Para linhas corrigidas, crie novo CSV e use nova chave. Referências duplicadas no mesmo arquivo são rejeitadas a partir da segunda ocorrência.