Plataforma Fiscal – Varejo

Árvore de páginas



01. DADOS GERAIS

Produto:

TOTVS Varejo Gestão Fiscal

Linha de Produto:

Linha Processos Fiscais

Segmento:

Varejo

Módulo:NFS-e
Função:Emissão, Cancelamento e Consulta de NFS-e
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DVARLVN-1502


02. SITUAÇÃO/REQUISITO

Criar API para Emissão, Cancelamento e Consulta de NFS - e.

03. SOLUÇÃO

Efetuado o ajusta no TOTVs Processos Fiscais, criando a API para emissão, cancelamento e consulta de NFS-e.

  • Emissão:
Método:POST
Endpoint:https://plataformafiscal.totvs.com.br/nfse/emissao


Exemplo Json:

{
	"numeroRps": Número do RPS,
	"serieRps": Número de série do RPS,
	"tipoRps": Código de tipo de RPS: 1 – RPS ; 2 - Nota Fiscal Conjugada (Mista) ; 3 - Cupom Tipo Padrão: 1 ; 4 - RPS-C - Recibo provisório de serviços	simplificado,
	"dataEmissao": "Data de emissão (AAAA-MM-DDTHH:mm:ss)",
	"prestador": {
		"cnpj": "CNPJ do prestador",
		"inscricaoMunicipal": "Inscrição municipal do prestador",
		"simplesNacional": Optante pelo simples nacional: 1 – Sim; 2 – Não",
		"incentivadorCultural": Incentivador cultural / fiscal: 1 – Sim; 2 – Não,
		"endereco": {
			"logradouro": Tipo e nome do logradouro,
			"numero": Número do lograduro,
			"complemento": Complemento do endereço,
			"bairro": Bairro,
			"codigoMunicipio": Código do município do tomador do serviço. Código de identificação do município conforme tabela do IBGE,
			"uf": Código da UF,
			"codigoPais": Código do país,
			"cep": CEP da localidade
		}
	},
	"tomador": {
		"razaoSocial": "Razão Social ou nome completo do Tomador",
		"cnpjCpf": CNPJ ou CPF do tomador,
		"endereco": {
			"logradouro":  Tipo e nome do logradouro,
			"numero": Número do lograduro,
			"complemento": Complemento do endereço,
			"bairro": Bairro,
			"codigoMunicipio": Código do município do tomador do serviço. Código de identificação do município conforme tabela do IBGE,
			"uf": "Código da UF",
			"codigoPais": "Código do país",
			"cep": "CEP da localidade"
		}
	},
	"servicos": [
	{
		"valores": {
			"valorServico": Valor total dos serviços,
			"valorIss": Valor do ISS do Serviço.,
			"aliquotaIss": Valor percentual da alíquota do ISS,
			"valorPis": Valor do PIS,
			"valorCofins": Valor do Confins,
			"valorInss": Valor do INSS,
			"valorIr": Valor do IR,
			"valorCsll": Valor do CSLL
		},
	"issRetido": 2Recolhimento. Identificação de Sim/Não: 1 - Sim; 2 – Não,
	"discriminacao": "Descrição/ Dados Complementares do RPS",
	"codigoMunicipio": Código do municipio de prestação do serviço. Código de identificação do município conforme tabela do IBGE,
	"codigoPais": Código do país,
	"municipioIncidencia": Código IBGE do municipio de incidencia do imposto,
	"itemListaServico": "Código do serviço prestado Item da LC 116/2003",
	"exigibilidadeISS": 1 - Exigível; 2 - Não incidência; 3 - Isenção; 4 - Exportação; 5 - Imunidade; 6 - Exigibilidade Suspensa por Decisão Judicial; 7 - Exigibilidade Suspensa por Processo Administrativo
	}
	]
}


Exemplo Json Retorno:

{
	"identificacao": "61254f4cf769414f0195491d"
}


  • Cancelamento:
Método:POST
Endpoint:https://plataformafiscal.totvs.com.br/nfse/cancelar


Exemplo Json Envio:

{
  "codigoCancelamento": Código do motivo do cancelamento,
  "codigoMunicipio": Código do município do Prestador,
  "inscricaoMunicipal": "Inscrição municipal do Prestador",
  "motivoCancelamento": "Serviço não prestado",
  "numeroNFSe": Número da NFS-e para cancelar,
  "cnpjPrestador": "CPF/CNPJ do prestador."
}


Exemplo Json Retorno:

{
	"identificacao": "6116ba8458a5666fb38778de"
}


  • Consulta Emissão:
Método:GET
Endpoint:https://plataformafiscal.totvs.com.br/nfse/{inserir_id}/retorno?tipo=EMISSAO


Exemplo Json Retorno:

{
  {
   "cnpjPrestador": "XXXXXXXXXXXXXX",
   "numeroRPS": 330,
   "numeroNFSe": 185,
   "dataEmissao": "2021-08-24T15:05:38",
   "codigoVerificacao": "8413.CFF7",
   "outrasInformacoes": "A Autenticidade desta NFS-e pode ser verificada no site http://www.canela.rs.gov.br/,  item NFS-e, menu Consulta de Autenticidade da NFS-e.",
   "statusPrefeitura":    {
      "codigoStatus": 100,
      "descricaoCodigoStatus": "NFSe emitida pela Prefeitura"
   }
}



  • Consulta Cancelamento:
Método:GET
Endpoint:https://plataformafiscal.totvs.com.br/nfse/{inserir_id}/retorno?tipo=CANCELAMENTO


Exemplo Json Retorno:

{
   "cnpjPrestador": "XXXXXXXXXXXXXX",
   "numeroRPS": 148,
   "numeroNFSe": 186,
   "dataCancelamento": "2021-08-24T16:36:24",
   "statusPrefeitura":    {
      "codigoStatus": 101,
      "descricaoCodigoStatus": "NFSe cancelada."
   }
}


  • Obter XML de Emissão:
Método:GET
Endpoint:https://plataformafiscal.totvs.com.br/nfse/{inserir_id}/retorno?tipo=EMISSAO&comXml=true


Exemplo Json Retorno:

{
   "cnpjPrestador": "XXXXXXXXXXXXXX",
   "numeroRPS": 330,
   "numeroNFSe": 185,
   "dataEmissao": "2021-08-24T15:05:38",
   "codigoVerificacao": "8413.CFF7",
   "outrasInformacoes": "A Autenticidade desta NFS-e pode ser verificada no site http://www.canela.rs.gov.br/,  item NFS-e, menu Consulta de Autenticidade da NFS-e.",
   "statusPrefeitura":    {
      "codigoStatus": 100,
      "descricaoCodigoStatus": "NFSe emitida pela Prefeitura"
   },
   "xml": "<nfsePrefeitura>Conteúdo da NFS-e</nfsePrefeitura>"
}


  • Obter XML de Cancelamento:
Método:GET
Endpoint:https://plataformafiscal.totvs.com.br/nfse/6116ba8458a5666fb38778de/retorno?tipo=CANCELAMENTO&comXml=true


Exemplo Json Retorno:

{
   "cnpjPrestador": "94120607000159",
   "numeroRPS": 148,
   "numeroNFSe": 186,
   "dataCancelamento": "2021-08-24T16:36:24",
   "statusPrefeitura":    {
      "codigoStatus": 101,
      "descricaoCodigoStatus": "NFSe cancelada."
   },
   "xml": "<nfsePrefeitura>Conteúdo da NFS-e</nfsePrefeitura>"
}