---
title: "[Progic] Como enviar a base de colaboradores: API v2 e planilha"
description: Aprenda a enviar a base de colaboradores na Progic usando a API v2 ou planilha. Veja as novas opções de identificador, campos aceitos e como integrar dados de RH.
---
[Pular para o conteúdo](https://help.progic.com.br/pt/como-enviar-a-base-de-colaboradores-api-v2-e-planilha#main-content)
Português
Mostrar submenu para traduções
Abrir navegação principal
Fechar navegação principal
- Português
Mostrar submenu para traduções
- [Nosso contato](https://ty05a.share.hsforms.com/2RIyv8iaWR9qVScnzVXKQSQ)
[Nosso contato](https://ty05a.share.hsforms.com/2RIyv8iaWR9qVScnzVXKQSQ)
Como podemos ajudá-lo?
- Não há sugestões porque o campo de pesquisa está em branco.
1. [Central de Ajuda](https://help.progic.com.br/pt?hsLang=pt)
2. [Plataforma](https://help.progic.com.br/pt/plataforma?hsLang=pt)
3. [Integrações & Segurança](https://help.progic.com.br/pt/plataforma?hsLang=pt#integra%C3%A7%C3%B5es-seguran%C3%A7a)
# \[Progic\] Como enviar a base de colaboradores: API v2 e planilha
A versão 2 da API de Colaboradores e a nova planilha de importação ampliam as informações que podem ser enviadas para a plataforma e permitem escolher como cada colaborador é identificado.
Com esses recursos, é possível integrar a base de colaboradores mesmo quando o sistema de origem não utiliza CPF como identificador, além de enviar dados como nome social, identidade de gênero, período de férias, listas de segmentação e o código da empresa usado no login.
> 💡 **Importante:** a versão 1 da API e o modelo antigo de planilha continuam funcionando normalmente. Nenhum dos campos novos é obrigatório, e a simples adoção da versão 2 não altera integrações existentes.
> 🔗 **Usa Senior ou TOTVS?** Este artigo trata da API de Colaboradores, usada quando o sistema da sua empresa envia os dados para a Progic. Se a sua empresa usa Senior ou TOTVS, também é possível conectar a plataforma diretamente ao sistema de RH, sem desenvolvimento. Veja \[Progic\] [Como configurar uma integração da base de colaboradores com o sistema de RH.](https://help.progic.com.br/pt/como-configurar-uma-integra%C3%A7%C3%A3o-da-base-de-colaboradores-com-o-sistema-de-rh?hsLang=pt)
### Neste artigo
- Como escolher o identificador único do colaborador
- Informações que passaram a ser aceitas
- Como enviar os dados originais do sistema de RH
- Layouts da planilha de importação
- O que não muda
- Mensagens de erro mais comuns
- Perguntas frequentes
- Boas práticas
### Como escolher o identificador único do colaborador
O identificador único é a informação que a plataforma usa para reconhecer um colaborador já cadastrado e decidir entre criar um novo registro ou atualizar o existente.
Antes, esse identificador era sempre o CPF. Agora é possível escolher entre três opções:
- CPF (opção padrão);
- código da empresa + matrícula;
- e-mail corporativo.
A escolha vale tanto para a API quanto para a importação por planilha.
### O que passa a ser obrigatório
Somente os campos escolhidos como identificador são obrigatórios. Os demais deixam de ser exigidos:
- ao usar PIN, o PIN é obrigatório;
- ao usar código da empresa + matrícula, os dois campos são obrigatórios e o CPF passa a ser opcional;
- ao usar e-mail, o e-mail é obrigatório e o CPF passa a ser opcional.
#### Cuidados na escolha
- A matrícula sozinha pode se repetir entre empresas diferentes. Por isso ela só funciona como identificador quando combinada com o código da empresa;
- Ao usar e-mail, garanta que não existam colaboradores com o mesmo endereço na mesma conta. A verificação não diferencia maiúsculas de minúsculas;
- Trocar o identificador de uma base já integrada exige atenção, porque registros criados com um identificador podem não ser reconhecidos por outro.
### Informações que passaram a ser aceitas
A versão 2 aceita, além dos campos já existentes:
- identificador do sistema de origem: o código do colaborador no sistema de folha ou de RH;
- código da empresa: utilizado no login, por exemplo PROGIC ou EINSTEIN;
- nome social e sobrenome social;
- sexo: MALE, FEMALE, INTERSEX, NOT\_SPECIFIED, PREFER\_NOT\_TO\_SAY;
- identidade de gênero: MAN, WOMAN, NON\_BINARY, NOT\_SPECIFIED, PREFER\_NOT\_TO\_SAY;
- listas de segmentação: em quais listas o colaborador deve ser incluído;
- domínio e usuário do Windows: no formato DOMINIO\\usuario, com até 255 caracteres;
- início e fim de férias;
- data de desligamento, disponível na API. Ela também é preenchida automaticamente sempre que o status do colaborador passa para Bloqueado.
As listas de segmentação devem ser informadas pelos códigos numéricos das listas já cadastradas na conta, separados por vírgula, por exemplo 1,2. Nomes de lista não são aceitos.
### Como enviar os dados originais do sistema de RH
Cada informação do colaborador pode ser enviada também em sua versão original, ou seja, como está no sistema de RH.
Esses campos são opcionais e existem por dois motivos:
- permitir comparar, a cada integração, o que mudou no sistema de origem;
- servir de base para as regras de padronização dos dados, já disponíveis nas integrações com sistemas de RH.
Na maior parte dos campos, o valor é mantido como veio da origem, sem remoção de espaços, ajuste de maiúsculas e minúsculas ou conversão de formato de data. Alguns campos, como o PIN, têm tratamento próprio, e a plataforma diferencia campo ausente, valor nulo e valor vazio. Por isso é possível enviar, por exemplo, a data de admissão original como 08/06/2022 mesmo que o campo padrão da plataforma utilize outro formato.
Você pode preencher apenas os campos padrão, apenas os campos originais, ou os dois conjuntos na mesma operação.
### Layouts da planilha de importação
A importação por planilha aceita três formatos, e a plataforma identifica qual está sendo usado pela quantidade de colunas:
| **Layout** | **Colunas** | **Quando usar** |
| --- | --- | --- |
| Original | 16 | Planilhas já em uso, sem alteração |
| Ampliado | 24 | Para utilizar os campos novos |
| Ampliado com dados originais | 49 | Para enviar também os valores exatamente como estão no sistema de RH |
A leitura do arquivo passou a tratar corretamente valores entre aspas que contenham vírgulas, o que evita erros em campos como cargo e departamento.
### O que não muda
- A versão 1 da API continua funcionando normalmente;
- A planilha no formato anterior continua funcionando normalmente;
- Nenhum campo novo é obrigatório;
- Campos não enviados permanecem com o valor que já estava registrado.
### Mensagens de erro mais comuns
As mensagens de retorno passaram a indicar exatamente o que precisa ser corrigido, em vez de apresentar um erro genérico.
| **Situação** | **O que fazer** |
| --- | --- |
| Valor inválido para sexo ou identidade de gênero | A mensagem lista os valores aceitos. Utilize um deles |
| Lista de segmentação informada por nome | Utilize os códigos numéricos das listas, separados por vírgula |
| Código de lista inexistente | Confirme se a lista existe e pertence à sua conta |
| Código da empresa inválido | Confirme o código configurado para a sua conta |
| Fim de férias anterior ao início | Revise as duas datas |
| Domínio do Windows fora do padrão | Utilize o formato DOMINIO\\usuario |
Quando uma atualização não é aplicada porque o campo está protegido no cadastro, a plataforma também informa a situação.[Veja mais sobre proteção de campos.](https://help.progic.com.br/pt/log-base-de-colaboradores?hsLang=pt)
### Perguntas frequentes
#### Preciso migrar para a versão 2 agora?
Não. A versão 1 continua funcionando. A versão 2 é necessária apenas para utilizar os campos novos e a escolha de identificador único.
#### Posso continuar usando minha planilha atual?
Sim. O modelo anterior, de 16 colunas, continua sendo aceito.
#### Posso deixar de enviar o CPF?
Sim, desde que o identificador único escolhido seja outro. Nesse caso o CPF passa a ser opcional.
#### Preciso preencher todos os campos novos?
Não. Todos são opcionais e os campos não enviados mantêm o valor já registrado.
#### Preciso enviar os dados originais do sistema de RH?
Não. Eles são opcionais, mas recomendados: guardam os valores como estão no sistema de RH e permitem comparar o que mudou a cada envio.
#### A data de desligamento precisa estar na planilha?
Não. Ela pode ser enviada pela API e é preenchida automaticamente quando o status do colaborador passa para Bloqueado.
#### Se eu deixar de enviar um colaborador, ele é bloqueado?
Não. Deixar de enviar um colaborador não altera o cadastro dele. Para bloqueá-lo, envie a alteração de status para Bloqueado. A data de desligamento é preenchida automaticamente nesse momento.
#### Como confirmo que a integração funcionou?
Consulte o Histórico de Operações de Colaboradores, na Central de Auditoria. Ele registra cada chamada de API, importação e alteração manual, com os campos modificados em cada cadastro. [Confira o artigo sobre Log de integração da base de colaboradores.](https://help.progic.com.br/pt/log-base-de-colaboradores?hsLang=pt)
### Boas práticas
- Defina o identificador único antes de iniciar a integração e mantenha o mesmo critério ao longo do tempo;
- Envie os dados originais do sistema de RH sempre que possível, para facilitar a comparação entre envios e a padronização dos dados;
- Após cada importação ou integração, confira os indicadores no Histórico de Operações de Colaboradores;
- Utilize a proteção de campos para as informações que precisam ser mantidas manualmente;
- Valide os códigos das listas de segmentação antes de incluí-los na integração;
- Teste com um grupo pequeno de colaboradores antes de processar a base completa.
### Artigos relacionados
- [\[Progic\] Log de integração da base de colaboradores](https://help.progic.com.br/pt/log-base-de-colaboradores?hsLang=pt)
- [\[Progic\] Como configurar uma integração da base de colaboradores com o sistema de RH](https://help.progic.com.br/pt/como-configurar-uma-integra%C3%A7%C3%A3o-da-base-de-colaboradores-com-o-sistema-de-rh?hsLang=pt)
- \[Progic\] Data de desligamento do colaborador
- [TV Corporativa](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#main-content)
- [Canais e Campanhas](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#canais-e-campanhas)
- [Mídias e Uploads](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#m%C3%ADdias-e-uploads)
- [Recursos Criativos & Editorias](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#recursos-criativos-editorias)
- [Playlists](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#playlists)
- [Conectividade & Rede](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#conectividade-rede)
- [Gestão de Usuários & Acesso](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#gest%C3%A3o-de-usu%C3%A1rios-acesso)
- [Manager](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#manager)
- [Transmissão & Monitoramento](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#transmiss%C3%A3o-monitoramento)
- [Instalação & Configuração Inicial](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#instala%C3%A7%C3%A3o-configura%C3%A7%C3%A3o-inicial)
- [Telas LG (WebOS)](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#telas-lg-webos)
- [Softplayers](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#softplayers)
- [Simplifica TV (Descontinuado)](https://help.progic.com.br/pt/tv-corporativa?hsLang=pt#simplifica-tv-descontinuado)
- [Plataforma](https://help.progic.com.br/pt/plataforma?hsLang=pt#main-content)
- [Integrações & Segurança](https://help.progic.com.br/pt/plataforma?hsLang=pt#integra%C3%A7%C3%B5es-seguran%C3%A7a)
- [Configuração e Acessos](https://help.progic.com.br/pt/plataforma?hsLang=pt#configura%C3%A7%C3%A3o-e-acessos)
- [Gestão e Operação](https://help.progic.com.br/pt/plataforma?hsLang=pt#gest%C3%A3o-e-opera%C3%A7%C3%A3o)
- [Dicas e Boas Práticas](https://help.progic.com.br/pt/plataforma?hsLang=pt#dicas-e-boas-pr%C3%A1ticas)
- [Aplicativos](https://help.progic.com.br/pt/aplicativos?hsLang=pt#main-content)
- [Mobile](https://help.progic.com.br/pt/aplicativos?hsLang=pt#mobile)
- [Desktop](https://help.progic.com.br/pt/aplicativos?hsLang=pt#desktop)
- [E-mail](https://help.progic.com.br/pt/e-mail?hsLang=pt#main-content)
- [Configuração e Segurança](https://help.progic.com.br/pt/e-mail?hsLang=pt#configura%C3%A7%C3%A3o-e-seguran%C3%A7a)
- [Dúvidas e Solução de Problemas](https://help.progic.com.br/pt/e-mail?hsLang=pt#d%C3%BAvidas-e-solu%C3%A7%C3%A3o-de-problemas)
- [Novo Gerenciador Caqui](https://help.progic.com.br/pt/novo-gerenciador-caqui?hsLang=pt)
[](https://progic.com.br/?utm_source=hubspot)
Copyright © 2026, Progic