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.
Comentários
0 comentário
Por favor, entre para comentar.