# Enviar RPS assíncrono

## Endpoint

<mark style="color:green;">`POST`</mark> `https://sandbox-api.invoisys.com.br/api/nfse/enviocompleto_async`

#### Headers

| Name          | Type   | Description                         |
| ------------- | ------ | ----------------------------------- |
| Content-type  | string | `application/x-www-form-urlencoded` |
| Accept        | string | `application/json`                  |
| Authorization | string | `bearer <valor>`                    |

#### Request Body

<table><thead><tr><th width="159">Name</th><th width="89.79998779296875">Type</th><th width="91.20001220703125">Tamanho</th><th width="288.60003662109375">Description</th><th width="98.4000244140625">Grupo</th></tr></thead><tbody><tr><td><sub>ambiente<mark style="color:red;">*</mark></sub></td><td><sub>integer</sub></td><td><sub>1</sub></td><td><sub>1 = Produção;</sub> <br><sub>2 = Homologação</sub></td><td><sub>-</sub></td></tr><tr><td><sub>dhEmissao</sub></td><td><sub>string</sub></td><td><sub>25</sub></td><td><sub>Informe a data de emissão do RPS no formato <code>"2025-05-20T18:50:33-03:00"</code>.</sub><br><sub>Se não informada no JSON, a invoiSys preencherá automaticamente com a data do envio no endpoint.</sub></td><td><sub>-</sub></td></tr><tr><td><sub>dhCompetencia</sub></td><td><sub>string</sub></td><td><sub>25</sub></td><td><sub>Informe a data de competência no formato <code>"2025-05-20T18:50:33-03:00"</code>.</sub><br><sub>Se não informada, a invoiSys preencherá automaticamente <strong>caso o campo seja obrigatório no município</strong></sub></td><td><sub>-</sub></td></tr><tr><td><sub>cnpjEmitente<mark style="color:red;">*</mark></sub></td><td><sub>string</sub></td><td><sub>14</sub></td><td><sub>Informar CNPJ do Emitente</sub></td><td><sub>-</sub></td></tr><tr><td><sub>serieRPS<mark style="color:red;">*</mark></sub></td><td><sub>string</sub></td><td><sub>5</sub></td><td><sub>Informar a série do RPS</sub></td><td><sub>-</sub></td></tr><tr><td><sub>numeroRPS<mark style="color:red;">*</mark></sub></td><td><sub>integer</sub></td><td><sub>6</sub></td><td><sub>Informar o número do RPS</sub></td><td><sub>-</sub></td></tr><tr><td><sub>nfseSubstituida</sub></td><td><sub>string</sub></td><td><sub>15</sub></td><td><sup>Em caso de substituição, informar o número da NFS-e a ser substituída</sup></td><td><sub>-</sub></td></tr><tr><td><sub>cpfTomador</sub></td><td><sub>string</sub></td><td><sub>11</sub></td><td><sub>Informar o CPF do Tomador, se for identificado. Se preenchido, deixar CNPJ em branco</sub></td><td><sub>-</sub></td></tr><tr><td><sub>cnpjTomador</sub></td><td><sub>string</sub></td><td><sub>14</sub></td><td><sub>Informar o CNPJ do Tomador, se for identificado. Se preenchido, deixar CPF em branco</sub></td><td><sub>-</sub></td></tr><tr><td><sub>nomeRazaoSocialTomador</sub></td><td><sub>string</sub></td><td><sub>1-150</sub></td><td><sub>Informar a Razão Social do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>apelidoNomeFantasiaTomador</sub></td><td><sub>string</sub></td><td><sub>1-150</sub></td><td><sub>Informar o Nome Fantasia do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>tipoDeLogradouroTomador</sub></td><td><sub>string</sub></td><td><sub>1-25</sub></td><td><sub>Informar o tipo de logradouro do Tomador. Ex.: Rua, Avenida, etc.</sub></td><td><sub>-</sub></td></tr><tr><td><sub>cepTomador</sub></td><td><sub>string</sub></td><td><sub>8</sub></td><td><sub>Informar o CEP do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>logradouroTomador</sub></td><td><sub>string</sub></td><td><sub>1-125</sub></td><td><sub>Informar o logradouro do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>numeroEnderecoTomador</sub></td><td><sub>string</sub></td><td><sub>1-10</sub></td><td><sub>Informar o número do endereço do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>bairroTomador</sub></td><td><sub>string</sub></td><td><sub>1-60</sub></td><td><sub>Informar o bairro do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>codigoMunicipioTomador</sub></td><td><sub>integer</sub></td><td><sub>7</sub></td><td><sub>Informar o código IBGE do município do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>complementoEnderecoTomador</sub></td><td><sub>string</sub></td><td><sub>1-30</sub></td><td><sub>Informar o complemento do endereço do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>emailTomador</sub></td><td><sub>string</sub></td><td><sub>75</sub></td><td><sub>Informar o e-mail do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>telefoneTomador</sub></td><td><sub>string</sub></td><td><sub>15</sub></td><td><sub>Informar o número de telefone do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>ieTomador</sub></td><td><sub>integer</sub></td><td><sub>1-14</sub></td><td><sub>Informar a Inscrição Estadual do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>imTomador</sub></td><td><sub>integer</sub></td><td><sub>9-15</sub></td><td><sub>Informar a Inscrição Municipal do Tomador</sub></td><td><sub>-</sub></td></tr><tr><td><sub>servico<mark style="color:red;">*</mark></sub></td><td><sub>object</sub></td><td>-</td><td><sub>Objeto Serviço</sub></td><td><sub>-</sub></td></tr><tr><td><sub>codigo<mark style="color:red;">*</mark></sub></td><td><sub>string</sub></td><td><sub>3-9</sub></td><td><sub>Código de identificação do serviço prestado</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>valor<mark style="color:red;">*</mark></sub></td><td><sub>number</sub></td><td><sub>13v2</sub></td><td><sub>Valor do serviço prestado</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>deducoes</sub></td><td><sub>number</sub></td><td><sub>13v2</sub></td><td><sub>Valor de deduções do serviço</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>aliquotaServicos</sub></td><td><sub>number</sub></td><td><sub>2v4</sub></td><td><sub>Valor de alíquota do serviço</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>aliquotaPIS</sub></td><td><sub>number</sub></td><td><sub>2v4</sub></td><td><sub>Valor de alíquota do PIS</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>aliquotaCOFINS</sub></td><td><sub>number</sub></td><td><sub>2v4</sub></td><td><sub>Valor de alíquota do COFINS</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>aliquotaINSS</sub></td><td><sub>number</sub></td><td><sub>2v4</sub></td><td><sub>Valor de alíquota do INSS</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>aliquotaIR</sub></td><td><sub>number</sub></td><td><sub>2v4</sub></td><td><sub>Valor de alíquota do Imposto de Renda</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>aliquotaCSLL</sub></td><td><sub>number</sub></td><td><sub>2v4</sub></td><td><sub>Valor de alíquota da Contribuição Social sobre o Lucro Líquido</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>valorISS</sub></td><td><sub>number</sub></td><td><sub>13v2</sub></td><td><sub>Valor do ISS</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>outrasRetencoes</sub></td><td><sub>number</sub></td><td><sub>13v2</sub></td><td><sub>Valor de outras retenções</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>responsavelRetencao</sub></td><td><sub>string</sub></td><td>2</td><td><sub>Identificação do responsável pela retenção do ISS.</sub> <br><sub>1 = Tomador;</sub> <br><sub>2 = Intermediário</sub></td><td><sub>servico</sub></td></tr><tr><td><sub>discriminacao<mark style="color:red;">*</mark></sub></td><td><sub>string</sub></td><td><sub>1-2000</sub></td><td><sub>Preencher com as informações referentes ao serviço a ser comercializado.</sub></td><td>-</td></tr><tr><td><sub>observacao</sub></td><td><sub>string</sub></td><td><sub>1-2000</sub></td><td><sub>Informar alguma observação relevante à operação</sub></td><td><sub>-</sub></td></tr><tr><td><sub>codigoTributacaoMunicipio</sub></td><td><sub>string</sub></td><td><sub>1-20</sub></td><td><sub>Informar o código de tributação do município.</sub></td><td><sub>-</sub></td></tr><tr><td><sub>cnae</sub></td><td><sub>string</sub></td><td><sub>1-7</sub></td><td><sub>Informar o CNAE</sub></td><td><sub>-</sub></td></tr><tr><td><sub>issRetido<mark style="color:red;">*</mark></sub></td><td><sub>boolean</sub></td><td><sub>true ou false</sub></td><td><sub>Informar se o ISS será retido. Se sim, o valor ISS retido será calculado automaticamente.</sub></td><td><sub>-</sub></td></tr><tr><td><sub>tipoDeTributacaoInvoisys</sub></td><td><sub>integer</sub></td><td><sub>2</sub></td><td><sub>Informar o tipo de tributação, conforme padrão dos</sub> <a data-mention href="#enumeradores">#enumeradores</a></td><td><sub>-</sub></td></tr><tr><td><sub>tipoDeTributacao</sub></td><td><sub>string</sub></td><td><sub>2</sub></td><td><sub>Campo livre para preenchimento do Tipo de Tributação, se não usado o enumerador oficial</sub></td><td><sub>-</sub></td></tr><tr><td><sub>regimeEspecialTributacaoInvoiSys</sub></td><td><sub>integer</sub></td><td><sub>2</sub></td><td><sub>Informar o tipo de tributação, conforme padrão dos</sub> <a data-mention href="#enumeradores">#enumeradores</a></td><td><sub>-</sub></td></tr><tr><td><sub>regimeEspecialTributacao</sub></td><td><sub>string</sub></td><td><sub>2</sub></td><td><sub>Campo livre para preenchimento do Regime Especial Tributação, se não usado o enumerador oficial</sub></td><td><sub>-</sub></td></tr><tr><td><sub>exigibilidadeISSInvoisys</sub></td><td><sub>integer</sub></td><td><sub>2</sub></td><td><sub>Informar o tipo de tributação, conforme padrão dos</sub> <a data-mention href="#enumeradores">#enumeradores</a></td><td><sub>-</sub></td></tr><tr><td><sub>exigibilidadeISS</sub></td><td><sub>integer</sub></td><td><sub>2</sub></td><td><sub>Campo livre para preenchimento da Exigibilidade do ISS, se não usado o enumerador oficial</sub></td><td><sub>-</sub></td></tr><tr><td><sub>incentivadorCultural<mark style="color:red;">*</mark></sub></td><td><sub>boolean</sub></td><td><sub>true ou false</sub></td><td><sub>Informar se o prestador é incentivador cultural</sub></td><td><sub>-</sub></td></tr><tr><td><sub>incentivoFiscal<mark style="color:red;">*</mark></sub></td><td><sub>boolean</sub></td><td><sub>true ou false</sub></td><td><sub>Informar se o prestador é incentivador fiscal</sub></td><td><sub>-</sub></td></tr><tr><td><sub>codigoMunicipioIncidencia</sub></td><td><sub>string</sub></td><td><sub>10</sub></td><td><sub>Código do município da incidência do ISS</sub></td><td><sub>-</sub></td></tr><tr><td><sub>descontoCondicional</sub></td><td><sub>number</sub></td><td><sub>13v2</sub></td><td><sub>Informar o desconto condicional para a operação</sub></td><td><sub>-</sub></td></tr><tr><td><sub>descontoIncondicional</sub></td><td><sub>number</sub></td><td><sub>13v2</sub></td><td><sub>Informar o desconto incondicional para a operação</sub></td><td><sub>-</sub></td></tr><tr><td><sub>tipoTomador</sub></td><td><sub>integer</sub></td><td><sub>2</sub></td><td><sub>Informar o tipo do tomador para municípios específicos</sub></td><td><sub>-</sub></td></tr><tr><td><sub>crc</sub></td><td><sub>integer</sub></td><td><sub>15</sub></td><td><sub>Conselho Regional de Contabilidade​, identificador do contador para municípios específicos</sub></td><td><sub>-</sub></td></tr><tr><td><sub>operacao</sub></td><td><sub>string</sub></td><td><sub>2</sub></td><td><sub>Campo para municípios específicos. Preencher com:</sub> <br><sub>“A”- Sem Dedução;</sub> <br><sub>“B”- Com Dedução/Materiais;</sub> <br><sub>“C” - Imune/Isenta de ISSQN;</sub> <br><sub>“D” - Devolução/Simples Remessa;</sub> <br><sub>“J” - Intermediação.</sub></td><td><sub>-</sub></td></tr><tr><td><sub>construcaoCivil</sub></td><td><sub>object</sub></td><td>-</td><td><sub>Objeto para dados de Construção Civil</sub></td><td><sub>-</sub></td></tr><tr><td><sub>codigoObra</sub></td><td><sub>string</sub></td><td><sub>15</sub></td><td><sub>Código identificador da obra</sub></td><td><sub>construcaoCivil</sub></td></tr><tr><td><sub>art</sub></td><td><sub>string</sub></td><td><sub>15</sub></td><td><sub>Número da ART</sub></td><td><sub>construcaoCivil</sub></td></tr><tr><td><sub>intermediario</sub></td><td><sub>object</sub></td><td>-</td><td><sub>Objeto para dados do Intermediário</sub></td><td><sub>-</sub></td></tr><tr><td><sub>cpfCnpj</sub></td><td><sub>object</sub></td><td>-</td><td><sub>Objeto para dados do CNPJ ou CPF do intermediário</sub></td><td><sub>intermediario</sub></td></tr><tr><td><sub>cpf</sub></td><td><sub>string</sub></td><td><sub>11</sub></td><td><sub>CPF do intermediário. Se preenchido, deixar CNPJ em branco</sub></td><td><sub>cpfCnpj</sub></td></tr><tr><td><sub>cnpj</sub></td><td><sub>string</sub></td><td><sub>14</sub></td><td><sub>CNPJ do intermediário. Se preenchido, deixar CPF em branco</sub></td><td><sub>cpfCnpj</sub></td></tr><tr><td><sub>razaoSocial</sub></td><td><sub>string</sub></td><td><sub>150</sub></td><td><sub>Razão social do intermediário</sub></td><td><sub>intermediario</sub></td></tr><tr><td><sub>inscricaoMunicipal</sub></td><td><sub>string</sub></td><td><sub>15</sub></td><td><sub>IM do intermediário</sub></td><td><sub>intermediario</sub></td></tr><tr><td><sub>tipoIss</sub></td><td><sub>string</sub></td><td><sub>2</sub></td><td><sub>Informar o tipo de ISS em municípios específicos</sub></td><td><sub>-</sub></td></tr><tr><td><sub>tipoEnquadramento</sub></td><td><sub>string</sub></td><td><sub>2</sub></td><td><sub>Informar o tipo de enquadramento em municípios específicos</sub></td><td><sub>-</sub></td></tr><tr><td><sub>devidoNoLocal</sub></td><td><sub>boolean</sub></td><td><sub>true ou false</sub></td><td><sub>Caso o serviço seja prestado fora do estabelecimento do prestador, colocar <code>true​</code></sub></td><td><sub>-</sub></td></tr><tr><td><sub>deducaoMaterial</sub></td><td><sub>number</sub></td><td><sub>13v2</sub></td><td><sub>Informar o valor de dedução deste material</sub></td><td><sub>-</sub></td></tr><tr><td><sub>numeroProcesso</sub></td><td><sub>string</sub></td><td><sub>30</sub></td><td><sub>Informar o número do processo em casos específicos</sub></td><td><sub>-</sub></td></tr></tbody></table>

{% tabs %}
{% tab title="Response" %}
{% tabs %}
{% tab title="200 - RPS criado" %}

```javascript
{
  "id": "4600",
  "excecao": null
}
```

{% endtab %}

{% tab title="400 - NFS-e já cancelada" %}

```csharp
{
  "id": "4588",
  "excecao": "Nota já existente. Status: Cancelado"
}
```

{% endtab %}

{% tab title="400 - Erro" %}

```
{
  "id": null,
  "excecao": "The field CNPJEmitente must be a string with a minimum length of 14 and a maximum length of 14."
}
```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

## Enumeradores

#### Tipo de tributação (tipoDeTributacaoInvoisys)

| <p>1 – Tributação no município<br>2 – Tributação fora do município<br>3 – Isenção<br>4 - Tributação fora do município, porém isento<br>5 - Tributação no município com isenção parcial<br>9 - Tributação no município, porém exigibilidade suspensa<br>10 - Tributação fora do município, porém exigibilidade suspensa<br>15 - Tributação no município, porém com indicação de imunidade subjetiva<br>16 - Tributação fora do município, porém com indicação de imunidade subjetiva<br>17 - Tributação no município, porém com indicação de imunidade objetiva<br>18 - Tributação fora do município, porém com indicação de imunidade objetiva<br>19 - Exportação de Serviços<br></p> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### Regime Especial Tributação (regimeEspecialTributacao)

| <p>1 – Microempresa municipal<br>2 – Estimativa<br>3 – Sociedade de profissionais<br>4 – Cooperativa<br>5 – Microempresário Individual (MEI)<br>6 – Microempresário e Empresa de Pequeno Porte (ME EPP)<br>7 – Tributação por Faturamento (Variável)<br>8 – Fixo<br>9 – Isenção<br>10 – Imune<br>11 – Exigibilidade suspensa por decisão judicial<br>12 – Exigibilidade suspensa por procedimento administrativo</p> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### Exigibilidade ISS (exigibilidadeISSInvoisys)

| <p>1 - Exigível;<br>2 - Não incidência;<br>3 - Isenção;<br>4 - Exportação;<br>5 - Imunidade;<br>6 - Exigibilidade Suspensa por Decisão Judicial;<br>7 - Exigibilidade Suspensa por Processo Administrativo</p> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

{% hint style="info" %}

#### Swagger

[Você pode acessar nossa API e realizar testes diretamente na nossa plataforma Swagger!](https://sandbox-api.invoisys.com.br/swagger/ui/index#/)
{% endhint %}

## APIs Relacionadas 🎈

* [Consulta Envio Assíncrono do RPS](/invoisys/endpoints/emissao-notas/nfs-e-1/api-consultar-rps-na-prefeitura-1.md)
* [Ambiente para Emissão](/invoisys/endpoints/outras-consultas/enumeradores/api-tipo-de-ambiente.md);
* ​[Município por ID e Nome](/invoisys/endpoints/outras-consultas/municipio/api-municipios.md);

## Referências à API 📌

* [Passo-a-Passo da NFS-e](/invoisys/getting-started/documentos-fiscais/emissao/nfs-e/passo-a-passo.md);
* [Fluxograma - Envio Síncrono](/invoisys/getting-started/documentos-fiscais/emissao/nfs-e/fluxo-operacional/fluxo-envio-sincrono-da-nfs-e.md);
* [Fluxograma - Envio Assíncrono](/invoisys/getting-started/documentos-fiscais/emissao/nfs-e/fluxo-operacional/fluxo-envio-assincrono-da-nfs-e.md);


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integracao.gitbook.io/invoisys/endpoints/emissao-notas/nfs-e-1/api-envio-completo-do-rps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.