Após realizar o cadastro da Empresa (emitente), é necessário gerar um JSON com os dados para envio. Abaixo, um exemplo de utilização da rota de envio.

 

Método HTTP: POST (Enviando)

 

URL

https://api.plugnotas.com.br/nfse

 

Headers

 

Nome	Descrição	Exemplo
accept	Indica o formato de retorno	application/json
Content-Type	Formato do conteúdo do body	application/json
x-api-key	Seu token do PlugNotas	TOKEN

 

BODY

 

[
 {
 "prestador": {
 "cpfCnpj": "08187168000160",
 "razaoSocial": "Tecnospeed TI S/A",
 "nomeFantasia": "Tecnospeed TI S/A",
 "inscricaoMunicipal": "12345",
 "inscricaoEstadual": "9044016688",
 "simplesNacional": false,
 "incentivoFiscal": false,
 "incentivadorCultural": false,
 "regimeTributario": 0,
 "regimeTributarioEspecial": 0,
 "email": "exemplo@erphub.com.br",
 "endereco": {
 "descricaoCidade": "Maringá",
 "cep": "87020025",
 "tipoLogradouro": "Avenida",
 "logradouro": "Duque de Caxias",
 "tipoBairro": "Centro",
 "codigoCidade": "4115200",
 "complemento": "17 andar",
 "estado": "PR",
 "numero": "882",
 "bairro": "Centro"
 },
 "telefone": {
 "ddd": "44",
 "numero": "43214321"
 }
 },
 "tomador": {
 "cpfCnpj": "99999999999999",
 "razaoSocial": "Empresa de Teste LTDA",
 "nomeFantasia": "Empresa de Teste",
 "inscricaoMunicipal": "8214100099",
 "inscricaoEstadual": "string",
 "email": "exemplo@erphub.com.br",
 "endereco": {
 "descricaoCidade": "Maringa",
 "cep": "87020100",
 "tipoLogradouro": "Rua",
 "logradouro": "Barao do rio branco",
 "tipoBairro": "Centro",
 "codigoCidade": "4115200",
 "complemento": "sala 01",
 "estado": "PR",
 "numero": "1001",
 "bairro": "Centro"
 },
 "telefone": {
 "ddd": "44",
 "numero": "99999999"
 }
 },
 "servico": {
 "codigo": "0107",
 "descricaoLC116": "Programação",
 "discriminacao": "Programação de software",
 "cnae": "00000",
 "codigoTributacao": "4115200",
 "codigoCidadeIncidencia": "4115200",
 "descricaoCidadeIncidencia": "MARINGA",
 "iss": {
 "exigibilidade": 1,
 "retido": false,
 "aliquota": 3,
 "aliquotaRetido": 2,
 "tipoTributacao": 7
 },
 "retencao": {
 "pis": {
 "aliquota": 0.65
 },
 "cofins": {
 "aliquota": 3
 },
 "csll": {
 "aliquota": 0
 }
 },
 "valor": {
 "deducoes": 0,
 "baseCalculo": 0.1,
 "servico": 45,
 "descontoIncondicionado": 0,
 "descontoCondicionado": 0,
 "liquido": 0.1
 }
 },
 "impressao": {
 "camposCustomizados": {
 "a": "1",
 "b": "1|2",
 "c": "1|2|3",
 "d": ""
 }
 },
 "enviarEmail": true
 }
]

Para quebra de linha na impressão, utilize o |. Ex: "discriminacao": "Programação de software | Linha 2 de descrição do serviço".

 

Campos Customizados

 

O nó "camposCustomizados" deve ser utilizado para mapear os campos que não são impressos por padrão, por não serem retornados pela prefeitura no XML da nota autorizada. Desta forma, o grupo "impressao", somente deve ser informado caso seja necessário o preenchimento de algum destes campos que estão disponíveis como campos customizáveis. Para verificar quais são os campos customizáveis disponíveis para o padrão que o município que deseja emitir adota, basta acessar nossa Documentação Técnica.

 

Código do Serviço

 

No grupo "servico", dentro de "codigo", deverá ser informado o Código de Serviço, podendo seguir a LC116, ou o padrão de códigos próprios adotados pelo município.

Caso seu município de emissão seja São Paulo, nós iremos mapear o código correspondente no município, ou seja, você não precisa se preocupar em mudar o tipo de integração para esta cidade.

 

RESPOSTA

 

O retorno será um Status Code 201, com um JSON no padrão abaixo:

{
    "documents" : [
        {
          "idIntegracao": "0922898-a",
          "prestador": "00000000000191",
          "id" : "5adf347aa679c716ea3c5234"
        }
  ],
  "protocol" : "e1682a88-13d5-4485-9083-e668d761ee42"
}

Grave o id retornado para utilizar em outras rotas e/ou fornecer a equipe de atendimento quando necessário.