Pular para o conteúdo principal

Baixando arquivo de erros de importação

Sobre este guia

Através deste guia, demonstraremos como baixar um arquivo de erros de importação. Esse cenário ocorrerá quando na importação o status voltar como FINISHED_WITH_ERRORS.

Passo a passo

Ambientes
  • Ambiente de homologação: https://uat-collaborators-api.acessorh.com.br;
  • Ambiente de produção: https://collaborators-api.acessorh.com.br.
  1. Obtenha um token OAuth válido

    Caso tenha dúvidas de como obter um token visite a seção sobre autenticação.

  2. Baixando o arquivo de erros de importação

    Após gerar um token de acesso válido, faça uma requisição para o endpoint de download do arquivo de erros na nossa API REST (GETapi/v1/file-import/{PROTOCOL_NUMBER}/error-file-url), enviando o protocolNumber e account.

    Parâmetro account

    Este parâmetro deve conter o UUID de qual account dentro da sua organization você deseja efetuar essa operação.

    Exemplo de formato de um UUID: 00000000-0000-0000-0000-000000000000

    Parâmetro protocolNumber

    Este parâmetro deve conter o identificador obtido ao solicitar uma importação de pessoas colaboradoras.

    Abaixo um exemplo da requisição:

    curl --location 'https://collaborators-api.acessorh.com.br/api/v1/file-import/{PROTOCOL_NUMBER}/error-file-url' \
    --header 'accountid: {ACCOUNT}'
    --header 'authorization: Bearer {ACCESS_TOKEN}'

    Após efetuar a requisição o arquivo será baixado e você poderá armazenar o mesmo para consulta.