2.0info: 3.69.0 integration_nfe description: Serviço para integração de títulos (pagar/receber) com o serviço de nota fiscal de entrada x-senior-domain: erpx_fin x-senior-domain-path: erpx_fin x-senior-service-path: integration_nfe contact: name: Senior X Platform url: https://dev.senior.com.br email: seniorx-dev@senior.com.brhost: platform.senior.com.br /t/senior.com.br/bridge/1.0/rest/erpx_finsecurityDefinitions: APIKeyHeader: type: apiKey in: header name: Authorizationsecurity: – APIKeyHeader: [] – application/json – application/jsonpaths: /integration_nfe/queries/healthcheck: post: description: Query para o SRE verificar a disponibilidade do serviço tags: – Queries x-senior-visibility: PRIVATE parameters: – name: input in: body required: true schema: type: object responses: 200: description: Ok schema: type: object required: – status – checks properties: status: type: string allOf: – #/definitions/upDown description: Status geral do serviço checks: type: array items: type: object allOf: – #/definitions/checkData minimum: 1 description: Verificações para assegurar o status 401: description: Invalid Credentials default: description: Error response schema: #/definitions/genericError get: description: Query para o SRE verificar a disponibilidade do serviço tags: – Queries x-senior-visibility: PRIVATE parameters: responses: 200: description: Ok schema: type: object required: – status – checks properties: status: type: string allOf: – #/definitions/upDown description: Status geral do serviço checks: type: array items: type: object allOf: – #/definitions/checkData minimum: 1 description: Verificações para assegurar o status 401: description: Invalid Credentials default: description: Error response schema: #/definitions/genericError /integration_nfe/queries/getMetadata: post: description: Default getMetadata query. Every service must handle this command and return metadata in the format requested. tags: – Queries x-senior-visibility: PRIVATE parameters: – name: input in: body required: true schema: type: object properties: metadataFormat: type: string description: responses: 200: description: Ok schema: type: object required: – metadata properties: metadata: type: string description: 401: description: Invalid Credentials default: description: Error response schema: #/definitions/genericError get: description: Default getMetadata query. Every service must handle this command and return metadata in the format requested. tags: – Queries x-senior-visibility: PRIVATE parameters: – name: metadataFormat description: in: query type: string responses: 200: description: Ok schema: type: object required: – metadata properties: metadata: type: string description: 401: description: Invalid Credentials default: description: Error response schema: #/definitions/genericError /integration_nfe/queries/getDependencies: post: description: Returns a list with all dependencies from this service, along with their respective versions tags: – Queries x-senior-visibility: PRIVATE responses: 200: description: Ok schema: type: object required: – dependencies properties: dependencies: type: array items: type: object allOf: – #/definitions/dependency minimum: 1 description: List with this service dependencies 401: description: Invalid Credentials default: description: Error response schema: #/definitions/genericError get: description: Returns a list with all dependencies from this service, along with their respective versions tags: – Queries x-senior-visibility: PRIVATE responses: 200: description: Ok schema: type: object required: – dependencies properties: dependencies: type: array items: type: object allOf: – #/definitions/dependency minimum: 1 description: List with this service dependencies 401: description: Invalid Credentials default: description: Error response schema: #/definitions/genericError /integration_nfe/actions/gerarTitulosNotaFiscalEntrada: post: description: Gerar Título via processo de nota fiscal de entrada tags: – Actions x-senior-visibility: PRIVATE parameters: – name: input in: body required: true schema: type: object required: – notaFiscalEntrada – parcelas properties: notaFiscalEntrada: type: object allOf: – #/definitions/recNotaFiscalEntrada description: Nota fiscal entrada notaFiscalDados: type: object allOf: – #/definitions/recNotaFiscalDados description: Dados nota fiscal parcelas: type: array items: type: object allOf: – #/definitions/recParcela minimum: 1 description: Parcelas loteFinanceiroReprocessamentoId: type: string description: Lote Financeiro reprocessamento responses: 200: description: Ok schema: type: object required: – loteFinanceiroId properties: loteFinanceiroId: type: string description: Lote financeiro gerado para o processo de geração de títulos via nota fiscal 401: description: Invalid Credentials default: description: Error response schema: #/definitions/genericError /integration_nfe/actions/excluirTitulosNotaFiscalEntrada: post: description: Excluir Título via processo de nota fiscal de entrada tags: – Actions x-senior-visibility: PRIVATE parameters: – name: input in: body required: true schema: type: object required: – notaFiscalEntradaId properties: notaFiscalEntradaId: type: string description: Identificador da nota fiscal fatoContabilId: type: string description: Identificador do fato contabil responses: 200: description: Ok schema: type: object 401: description: Invalid Credentials default: description: Error response schema: #/definitions/genericError /integration_nfe/actions/validarExclusaoTitulosNotaFiscalEntrada: post: description: Validar exclusão de título via processo de nota fiscal de entrada tags: – Actions x-senior-visibility: PRIVATE parameters: – name: input in: body required: true schema: type: object required: – notaFiscalEntradaId properties: notaFiscalEntradaId: type: string description: Identificador da nota fiscal responses: 200: description: Ok schema: type: object required: – exclusaoPermitida properties: exclusaoPermitida: type: boolean description: Identificador de permissão de exclusão motivo: type: string description: Mensagem indicando o motivo da não permissão de exclusão 401: description: Invalid Credentials default: description: Error response schema: #/definitions/genericErrordefinitions: upDown: description: Up or down type: string enum: – UP – DOWN enumTipImpDoc: description: Tipo de imposto documento type: string enum: – IPI – IPI_PRESUMIDO – IPI_DEVOLVIDO – IPI_CREDITADO – ICMS – ICMS_SIMPLES – ICMS_FUTURO – ICMS_DIFERIDO – ICMS_DESONERADO – ICMS_ST – ICMS_UF_DESTINO – ICMS_ISENTAS_OUTRAS – ICMS_CREDITADO – ICMS_EFETIVO – ICMS_ST_RETIDO_ANT – ICMS_ST_FUTURO – ICMS_ST_SOLIDARIO – ICMS_IMPORTACAO – ICMS_DESTINO – FCP – FCP_ST – FCP_UF_DESTINO – FCP_ST_RETIDO_ANT – ISS – COFINS – COFINS_RETIDO – COFINS_RECUPERAR_IMPORTACAO – COFINS_RECUPERAR – COFINS_DEVOLVIDO – PIS – PIS_RETIDO – PIS_RECUPERAR_IMPORTACAO – PIS_RECUPERAR – PIS_DEVOLVIDO – CSLL – ISS_RETIDO – IRRF – INSS – INSS_PATRONAL – IMPOSTO_IMPORTACAO – DIFAL – DIFAL_DEVOLVIDO – CIDE_TECNOLOGIA – FUNRURAL_TOTAL – FUNRURAL_INSS – FUNRURAL_RAT – FUNRURAL_SENAR enumRegimeCaixa: description: Origem do documento type: string enum: – CAIXA – COMPETENCIA enumMotDes: description: Motivo da desoneração type: string enum: – V0 – V1 – V2 – V3 – V4 – V5 – V6 – V7 – V8 – V9 – V10 – V11 – V12 – V16 – V90 enumOriMer: description: Origem fiscal da mercadoria type: string enum: – V0 – V1 – V2 – V3 – V4 – V5 – V6 – V7 – V8 enumAplLiq: description: Enumeração do tipo de aplicação do valor do imposto type: string enum: – VA – VS – VN tipoDiferimento: description: Indicativo de como será o tipo de diferimento type: string enum: – BASE – VALOR enumTipNfe: description: Tipos de nota fiscal de entrada type: string enum: – V1 – V2 – V4 – V6 – V8 – V9 – V10 – V12 enumImpostosRetidos: description: Impostos retidos type: string enum: – ISS_RETIDO – PIS_RETIDO – COFINS_RETIDO – CSLL – IRRF enumTituloOrigem: description: Origem do título type: string enum: – CONTAS_RECEBER – CONTAS_PAGAR userNotificationKind: description: User notification kind. type: string enum: – Operational – Management – News userNotificationPriority: description: User notification priority. type: string enum: – Error – Alert – None eventEmailFormat: description: Format of the email type: string enum: – HTML – PLAIN_TEXT checkData: description: Dados do healthcheck type: object required: – name – status properties: name: type: string description: Nome do healthcheck status: type: string allOf: – #/definitions/upDown description: Status do healthcheck recNotaFiscalDados: description: Informação dos dados da nota fiscal type: object required: – dadosGerais – itens properties: dadosGerais: type: object allOf: – #/definitions/recDadosGerais description: Informações do cabeçalho itens: type: array items: type: object allOf: – #/definitions/recItens minimum: 1 description: Informações dos itens recDadosGerais: description: Informações do cabeçalho da nota fiscal type: object required: – id – codigoEmpresa – numCgcCpfFilial – codigoFilial – consumidorFinalFilial – dataEmissao – dataEntrada – numCgcCpfCliente – codigoCliente – consumidorFinalCliente – serie – numero – valorFinanceiro properties: id: type: string description: Identificador da nota Fiscal codigoEmpresa: type: string description: Código da empresa numCgcCpfFilial: type: string description: Número CNPJ/CPF da filial nifFilial: type: string description: Número de identificação fiscal da filial codigoFilial: type: string description: Código da filial consumidorFinalFilial: type: boolean description: Indicativo se é consumidor final dataEmissao: type: string format: date-time description: Data/Hora emissão dataEntrada: type: string format: date-time description: Data/Hora entrada numCgcCpfCliente: type: string description: Número CNPJ/CPF do cliente nifCliente: type: string description: Número de identificação fiscal do cliente codigoCliente: type: string description: Código cliente consumidorFinalCliente: type: boolean description: Indicativo se é consumidor final serie: type: string description: Série da nota fiscal numero: type: string description: Número da nota fiscal valorFinanceiro: type: string description: Valor financeiro recItens: description: Informações dos itens da nota fiscal type: object required: – idItem – operacao – valoresItem properties: idItem: type: string description: Identificação do item no documento operacao: type: string description: Natureza de operação correspondente a transação finalidadeCompraVenda: type: string description: Código da Finalidade produto: type: object allOf: – #/definitions/recProduto description: Informações do produto servico: type: object allOf: – #/definitions/recServico description: Informações do serviço valoresItem: type: object allOf: – #/definitions/recValoresItem description: Informações de valores do item impostos: type: array items: type: object allOf: – #/definitions/recImpostos description: Informações dos impostos recProduto: description: Informações do produto type: object required: – codigoProduto properties: exIpi: type: string description: Exceção do IPI ncm: type: string description: Nomenclatura Comum do Mercosul codigoProduto: type: string description: Código do produto gtinEan: type: string description: Código EAN origemMercadoria: type: string description: Origem da mercadoria controlaEntradaSaida: type: boolean description: Controle Entrada/Saida ICMS ST (PEPS) recServico: description: Informações do serviço type: object required: – codigoServico properties: nbs: type: string description: Nomenclatura Brasileira de Serviços codigoServico: type: string description: Código do serviço lc1162003: type: string description: Código da Lei complementar 116/2003 recValoresItem: description: Informações de valores do item type: object required: – vlrFinanceiro – qtdTributavel – vlrUnitarioTributavel properties: vlrFinanceiro: type: string description: Valor financeiro do item qtdTributavel: type: number format: double description: Quantidade de venda do item vlrUnitarioTributavel: type: string description: Preço de venda do item vlrDesconto: type: string description: Valor de desconto do item vlrFreteNormal: type: string description: Valor de frete do item vlrFreteDestacado: type: string description: Valor de frete destacado do item vlrFreteImportacao: type: string description: Valor de frete importação do item valorAfrmm: type: string description: Valor afrmm do item vlrSeguro: type: string description: Valor de seguro do item valorSeguroImportacao: type: string description: Valor de seguro importacao do item vlrOutrasDespesas: type: string description: Valor de outras despesas do item vlrOutrasDespesasDestacadas: type: string description: Valor de outras despesas destacado do item valorOutrasDespesasImportacao: type: string description: Valor de outras despesas importação destacado do item vlrEncargos: type: string description: Valor de encargos do item vlrEmbalagens: type: string description: Valor de embalagens do item valorPedagio: type: string description: Valor pedágio valorVariacaoCambial: type: string description: Valor variação cambial indiceGrossUp: type: string description: Índice gross up indiceNegociado: type: string description: Índice negociado vlrLiquidoSemImposto: type: string description: Valor líquido do item recImpostos: description: Informações dos impostos da nota fiscal type: object required: – tipoImposto properties: valorBase: type: string description: Valor base valor: type: string description: Valor imposto aliquota: type: number format: double description: Alíquota do imposto tipoImposto: type: string allOf: – #/definitions/enumTipImpDoc description: Tipo de imposto controleRegimeCaixa: type: string allOf: – #/definitions/enumRegimeCaixa description: Controle regime caixa valorOutras: type: string description: Valor Outras valorIsentas: type: string description: Valor Isentas percentualReducao: type: number format: double description: Percentual de redução da base do imposto percentualMva: type: number format: double description: Percentual da margem de valor Adicionado do ICMS ST situacaoTributaria: type: string description: Situação Tributária enquadramentoIpi: type: string description: Enquadramento de IPI motivoDesoneracao: type: string allOf: – #/definitions/enumMotDes description: Motivo desoneração ICMS origemMercadoria: type: string allOf: – #/definitions/enumOriMer description: Origem fiscal da mercadoria aplicacaoImposto: type: string allOf: – #/definitions/enumAplLiq description: Aplicação do imposto aliquotaDestino: type: number format: double description: Alíquota de ICMS interestadual da UF de destino valorRecolhidoSubstituto: type: string description: Valor recolhido pelo substituto perSuportadoConsumidorFinal: type: number format: double description: Suportado consumidor final valorIcmsStRetido: type: string description: Valor Icms St retido tipoDiferimento: type: string allOf: – #/definitions/tipoDiferimento description: Tipo de diferimento ufOrigem: type: string description: Estado de origem ufDestino: type: string description: Estado de destino finalidadeCompraVenda: type: string description: Finalidade de compra e venda origemNfFreteTributado: type: string description: Origem nf frete tributado origemNfFreteNaoTributado: type: string description: Origem nf frete nao tributado municipio: type: string description: Município perfilTributarioCalculoImpostos: type: string description: Id do perfil tributário que contem os parametros de cálculo parametroCalculoImpostos: type: string description: Id do parametro usado para o calculo dos impostos recNotaFiscalEntrada: description: Informações da nota fiscal type: object required: – notaFiscalEntradaId – fatoContabilId – filialId – numero – serie – fornecedorId – tipNfe – guiaPorDocumento properties: notaFiscalEntradaId: type: string description: Identificador da nota fiscal fatoContabilId: type: string description: Identificador do fato contabil fatoContabilDescricao: type: string maxLength: 255 description: Descrição do fato contábil origem filialId: type: string description: Identificador da filial numero: type: integer format: int64 description: Número serie: type: object allOf: – #/definitions/recSerie description: Série contemRetencao: type: boolean description: Indicativo se a nota fiscal de entrada teve retenção fornecedorId: type: string description: Identificador do fornecedor tipNfe: type: string allOf: – #/definitions/enumTipNfe description: Tipo de nota fiscal guiaPorDocumento: type: boolean description: Indicativo se a nota gera guia de recolhimento por documento recSerie: description: Informações da série type: object required: – id – filialId properties: id: type: string description: Identificador da série filialId: type: string description: Identificador da filial codigo: type: string description: Código descricao: type: string description: Descrição recParcela: description: Dados do título financeiro (pagar/receber) type: object required: – numeroTitulo – tipoTituloId – dataEmissao – dataEntrada – vencimento – valor – moeda properties: numeroTitulo: type: string maxLength: 15 description: Nº Título tipoTituloId: type: string description: Identificador do tipo de título transacaoId: type: string description: Identificador da transação de entrada do título dataEmissao: type: string format: date description: Data Emissão dataEntrada: type: string format: date description: Data Entrada vencimento: type: string format: date description: Vencimento valor: type: string description: Valor minimum: 0.00 maximum: 9999999999999.99 moeda: type: object allOf: – #/definitions/recMoeda description: Moeda rateio: type: object allOf: – #/definitions/recRateio description: Rateio valoresNegociados: type: object allOf: – #/definitions/recValoresNegociados description: Dados negociados informacoesAdicionais: type: object allOf: – #/definitions/recInformacoesAdicionaisTitulo description: Informações adicionais codBarParcNfe: type: string description: Código de Barras recInformacoesAdicionaisTitulo: description: Indicativo das informações adicionados do título type: object properties: observacao: type: string maxLength: 250 description: Observação naturezaGastoId: type: string description: Natureza Gasto formaPagamentoId: type: string description: Forma Pagamento portadorId: type: string description: Portador carteiraId: type: string description: Carteira recRateio: description: Indicativo das informações para geração de rateio type: object properties: projetoId: type: string description: Indicativo do projeto faseProjetoId: type: string description: Indicativo da fase do projeto contaFinanceiraId: type: string description: Indicativo da conta financeira contaContabilId: type: string description: Indicativo da conta contábil centroCustosId: type: string description: Indicativo do centro de custos recMoeda: description: Indicativo das informações da moeda do título type: object required: – moedaId properties: moedaId: type: string description: Moeda Base cotacaoEmissao: type: string description: Cotação Moeda Emissão minimum: 0.00 maximum: 999999999.9999999999 recValoresNegociados: description: Indicativo das informações negociadas do título type: object properties: dataLimiteNegociacao: type: string format: date description: Data Valores Negociados juroNegociado: type: string description: Valor Juros Negociados minimum: 0.00 maximum: 9999999999999.99 multaNegociada: type: string description: Valor Multa Negociada minimum: 0.00 maximum: 9999999999999.99 descontoNegociado: type: string description: Valor Descontos Negociados minimum: 0.00 maximum: 9999999999999.99 outrosValoresNegociados: type: string description: Outros Negociados minimum: 0.00 maximum: 9999999999999.99 cotacaoNegociada: type: string description: Cotação Moeda Negociada minimum: 0.00 maximum: 999999999.9999999999 notifyUserEventPayload: description: Represents a regular user event notification payload discriminator: _discriminator type: object required: – notificationKind – notificationPriority – notificationSubject – notificationContent – sourceDomain – sourceService – destinationUser – _discriminator properties: notificationClass: type: string description: Class of notification notificationOrigin: type: string description: Origin of notification. Free text. Optional. notificationKind: type: string allOf: – #/definitions/userNotificationKind description: Notification kind. notificationPriority: type: string allOf: – #/definitions/userNotificationPriority description: Notification priority. notificationSubject: type: string description: Notification subject. notificationContent: type: string description: Notification content. sourceDomain: type: string description: Domain that generates the notification. sourceService: type: string description: Service that generates the notification. destinationUser: type: string description: Username of the destination user. link: type: string description: Notification link _discriminator: type: string description: emailNotifyUserEventPayload: description: Represents an email notification payload allOf: – #/definitions/notifyUserEventPayload – type: object required: – from properties: from: type: string description: Email sender address sendTo: type: array items: type: string description: Additional recipients to send the email to format: type: string allOf: – #/definitions/eventEmailFormat description: Email format pushNotifyUserEventPayload: description: Represents a push notification payload allOf: – #/definitions/notifyUserEventPayload – type: object required: – applicationId properties: applicationId: type: string description: Apple/Google application id blobReference: description: Default blob reference type. Every service defines its own. type: object required: – targetObjectId properties: domainName: type: string description: The domain the blob belongs to. serviceName: type: string description: The service the blob belongs to. targetObjectId: type: string description: The basic id of the blob. targetCopyId: type: string description: The id of the blob copy. basicErrorPayload: description: Default error payload type. Every service defines its own. type: object properties: message: type: string description: The user-facing error message, if any. errorCode: type: string description: The program-accessible (and service-specific) error code. dependency: description: Represents a service dependency type: object required: – domain – service – version properties: domain: type: string description: Domain of the dependency service service: type: string description: Name of the dependency service type: string description: Version of the dependency service genericError: properties: message: type: string description: Messaging describing the error. reason: type: string description: A symbolic code identifying the category of the reason of the error. enum: – BAD_REQUEST – UNAUTHORIZED – PAYMENT_REQUIRED – FORBIDDEN – OBJECT_NOT_FOUND – REQUEST_TIMEOUT – GONE – UNPROCESSABLE – INTERNAL_ERROR – NOT_IMPLEMENTED – SERVICE_UNAVAILABLE – INSUFFICIENT_STORAGE