> For the complete documentation index, see [llms.txt](https://integracao.gitbook.io/invoisys/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integracao.gitbook.io/invoisys/endpoints/emissao-notas/nfs-e-1/api-envio-completo-do-rps.md).

# 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);