---
title: "Enriquecimento via API: layout \"Padrão - Pesquisa Por Razão Social - PJ\""
description: "Aprenda a enriquecer uma lista de razões sociais pela API da Data Stone com o layout “Padrão - Pesquisa Por Razão Social - PJ”: envie o CSV, acompanhe a solicitação e baixe o resultado em três chamadas simples."
url: https://suporte.datastone.com.br/pt-br/articles/11385795-enriquecimento-via-api-layout-padrao-pesquisa-por-razao-social-pj
collection: "API"
updated: 2026-10-21
language: pt-br
---

# Enriquecimento via API: layout "Padrão - Pesquisa Por Razão Social - PJ"

Aprenda a enriquecer uma lista de razões sociais pela API da Data Stone com o layout “Padrão - Pesquisa Por Razão Social - PJ”: envie o CSV, acompanhe a solicitação e baixe o resultado em três chamadas simples.

Este artigo explica como enviar uma lista de razões sociais de pessoas jurídicas para enriquecimento por meio da API da Data Stone, utilizando o layout "Padrão - Pesquisa Por Razão Social - PJ" (ID 39), e como consultar o resultado depois de processado.

A documentação oficial completa está disponível em [Data Stone API](https://docs.datastone.com.br/api).

## Informações gerais

Base URL: `https://api.datastone.com.br/v1`

Autenticação: envie o header `Authorization: SUA_API_KEY` em todas as chamadas.

## Visão geral do fluxo

O enriquecimento acontece em três etapas:

1.  Listar os layouts disponíveis, para confirmar o ID e os parâmetros do layout desejado.
    
2.  Solicitar o enriquecimento, enviando o arquivo CSV com as razões sociais.
    
3.  Consultar o resultado, usando o ID retornado na solicitação.
    

## 1\. Listar os layouts

Utilize esta chamada para confirmar os IDs e os parâmetros de cada layout antes de solicitar o enriquecimento.

```javascript
GET https://api.datastone.com.br/v1/enrichment/layouts/
```

Headers:

```javascript
Authorization: SUA_API_KEY
```

## 2\. Solicitar o enriquecimento

```javascript
POST https://api.datastone.com.br/v1/enrichment/
```

Headers:

```javascript
Authorization: SUA_API_KEY
Content-Type: application/json
```

Body (raw JSON):

```json
{
  "name": "Nome do enriquecimento",
  "layout_id": 39,
  "parameters": [],
  "file": "UEsDBBQABgAIAAAAIQ...",
  "callback_email": "seuemail@empresa.com"
}
```

Descrição dos campos:

-   `name`: nome que identifica o enriquecimento.
    
-   `layout_id`: ID do layout. Para "Padrão - Pesquisa Por Razão Social - PJ", utilize 39.
    
-   `parameters`: lista de parâmetros do layout. Neste layout, envie a lista vazia.
    
-   `file`: arquivo CSV codificado em base64, com uma coluna chamada RAZAO SOCIAL.
    
-   `callback_email`: e-mail que será avisado quando o enriquecimento for concluído.
    

O arquivo CSV deve conter uma coluna RAZAO SOCIAL, com uma razão social por linha.

Resposta esperada:

```json
{
  "id": 98765,
  "status": "requested"
}
```

Guarde o valor de `id`, pois ele é utilizado na etapa seguinte para consultar o resultado.

## 3\. Consultar o resultado

```javascript
GET https://api.datastone.com.br/v1/enrichment/{id}/result/
```

Headers:

```javascript
Authorization: SUA_API_KEY
```

Substitua `{id}` pelo valor retornado na etapa 2.

Resposta quando o resultado estiver pronto:

```json
{
  "file": "https://storage.datastone.com.br/enrichment/results/98765-resultado.csv?token=...&expires=...",
  "metrics": {
    "Documentos enviados": 1,
    "Documentos enriquecidos": 1
  }
}
```

Descrição dos campos:

-   `file`: URL temporária do CSV com o resultado do enriquecimento. Como o link expira, faça o download assim que receber a resposta.
    
-   `metrics`: resumo do processamento, como a quantidade de documentos enviados e de documentos enriquecidos.
