# Documento Fiscal documentoFiscal ## PUT /documentoFiscal > Cadastrar Documento Fiscal ```json {"openapi":"3.0.1","info":{"title":"Loja","version":"1.0"},"tags":[{"name":"Documento Fiscal","description":"documentoFiscal"}],"servers":[{"url":"https://localhost/loja/v10"},{"url":"http://localhost/loja/v10"}],"security":[{"csw_auth":[]}],"components":{"securitySchemes":{"csw_auth":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"Erro":{"type":"object","properties":{"mensagem":{"type":"string"}}},"ListaDocumentoFiscalPut":{"type":"object","properties":{"documentosFiscais":{"type":"array","items":{"$ref":"#/components/schemas/DocumentoFiscalPut"}}}},"DocumentoFiscalPut":{"type":"object","required":["dataEmissao","tipoDocumento","codECF","numeroDocumento","tipoCliente","CNPJCPFCliente"],"properties":{"dataEmissao":{"type":"string","format":"date","description":"Data de emissão (YYYY-MM-DD)"},"tipoDocumento":{"type":"integer","description":"Tipo de documento (1-NF, 2-ECF)","enum":[1,2]},"codECF":{"type":"integer","maximum":999999999,"description":"Código do ECF"},"numeroDocumento":{"type":"integer","minimum":1,"maximum":999999999,"description":"Número do documento"},"tipoCliente":{"type":"integer","description":"Tipo do cliente (1-CNPJ, 2-CPF, 3-Exterior)","enum":[1,2,3]},"CNPJCPFCliente":{"type":"string","minLength":1,"maxLength":14,"description":"CNPJ/CPF do cliente - Para ECF repassar Zeros / Para Exterior repassar o código RUC"},"valorTotalNota":{"type":"number","multipleOf":0.01,"maximum":999999999.99,"description":"Valor total da nota"},"serieFiscal":{"type":"integer","minimum":1,"maximum":999,"description":"Série fiscal"},"observacao":{"type":"string","maxLength":1000,"description":"Observação"},"modeloDocumento":{"type":"integer","description":"Modelo do documento (55 – NF-e, 59 – CF-e SAT, 65 – NFC-e (Não repassar para ECF))","enum":[55,59,65]},"chaveNFeNFCe":{"type":"string","description":"Chave NFe/NFCe","minLength":44,"maxLength":44},"situacaoNota":{"type":"integer","description":"Situação da nota (0-Emitida, 1-Cancelada, 2-Inutilizada, 3-Contingência)","enum":[0,1,2,3]},"numeroSerieEquipamentoSAT":{"type":"integer","maximum":999999999,"description":"Número de série do equipamento SAT - Somente obrigatório para modelos de documento = 59 – CF-e SAT"},"protocoloAurizacao":{"type":"string","maxLength":36,"description":"Protocolo da autorização"},"protocoloCancelamento":{"type":"string","maxLength":36,"description":"Protocolo de cancelamento"},"motivoCancelamento":{"type":"string","maxLength":80,"description":"Motivo de cancelamento"},"dataCancelamento":{"type":"string","format":"date","description":"Data de cancelamento (YYYY-MM-DD)"},"pesoLiquido":{"type":"number","maximum":9999999.99,"multipleOf":0.01,"description":"Peso liquido"},"pesoBruto":{"type":"number","maximum":9999999.99,"multipleOf":0.01,"description":"Peso bruto"},"especieVolumes":{"type":"string","maxLength":80,"description":"Espécie dos volumes"},"quantidadeVolumes":{"type":"integer","maximum":999999999,"description":"Quantidade de volumes"},"notaFiscalComplemento":{"type":"integer","description":"Nota fiscal de complemento? (0-Não, 1-Sim)","enum":[0,1]},"itensDocumentoFiscal":{"type":"array","description":"Itens do documento fiscal","items":{"$ref":"#/components/schemas/ItensDocumentoFiscal"}},"duplicatasDocumentoFiscal":{"type":"array","description":"Duplicatas do documento fiscal","items":{"$ref":"#/components/schemas/duplicatasDocumentoFiscal"}},"dadosCustomizados":{"type":"array","items":{"$ref":"#/components/schemas/DadosCustomizados"}}}},"ItensDocumentoFiscal":{"type":"object","required":["sequenciaItem","codProdutoTag","quantidade"],"properties":{"sequenciaItem":{"type":"integer","minimum":1,"maximum":999,"description":"Sequência do item"},"codProdutoTag":{"type":"string","maxLength":24,"description":"Código do produto da TAG"},"quantidade":{"type":"number","maximum":999999999.999,"multipleOf":0.01,"description":"Quantidade do produto"},"precoUnitarioBruto":{"type":"number","maximum":999999999.99999,"multipleOf":0.01,"description":"Preço unitário - As casas decimais podem variar de 2 à 5 casas decimais, conforme a configuração no ERP Consistem."},"vlrTotalBruto":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor total bruto"},"vlrDesconto":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de desconto"},"cfop":{"type":"integer","minimum":1,"maximum":9999,"description":"Código da CFOP"},"baseICMS":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Base de ICMS"},"aliquotaICMS":{"type":"number","maximum":99.99,"multipleOf":0.01,"description":"Aliquota de ICMS"},"valorICMS":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de ICMS"},"valorICMSIsenta":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Base de ICMS isenta"},"valorICMSOutras":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Base de ICMS outras"},"cstICMS":{"type":"string","maxLength":2,"description":"Código CST ICMS"},"baseIPI":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Base de IPI"},"aliquotaIPI":{"type":"number","maximum":99.99,"multipleOf":0.01,"description":"Aliquota de IPI"},"valorIPI":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de IPI"},"valorIPIIsentas":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de IPI isentas"},"valorIPIOutras":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de IPI outras"},"cstIPI":{"type":"string","maxLength":2,"description":"Código do CST IPI"},"cstPIS":{"type":"string","maxLength":2,"description":"Código CST PIS"},"basePIS":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Base de PIS"},"aliquotaPIS":{"type":"number","maximum":99.99,"multipleOf":0.01,"description":"Aliquota de PIS"},"valorPIS":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de PIS"},"cstCofins":{"type":"string","maxLength":2,"description":"Código do CST COFINS"},"baseCOFINS":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Base de COFINS"},"aliquotaCOFINS":{"type":"number","maximum":99.99,"multipleOf":0.01,"description":"Aliquota de COFINS"},"valorCOFINS":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de COFINS"},"valorDIFALRemetente":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor DIFAL do remetente"},"valorDIFALDestinario":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor DIFAL destinatário"},"valorDIFALFCP":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor DIFAL FCP"},"valorOutrasDespesas":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de outras despesas"},"valorFrete":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de frete"},"baseST":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Base de ST"},"valorST":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor de ST"},"percentualFCPICMS":{"type":"number","multipleOf":0.01,"maximum":99.99,"description":"Base de ST"},"valorFCPICMS":{"type":"number","multipleOf":0.01,"maximum":9999999999.99,"description":"Valor FCP ICMS"},"percentualFCPST":{"type":"number","multipleOf":0.01,"maximum":99.99,"description":"Percentual FCP ST"},"valorFCPST":{"type":"number","multipleOf":0.01,"maximum":9999999999.99,"description":"Valor FCP ST"},"valorBaseIBSCBS":{"type":"number","multipleOf":0.01,"maximum":9999999999.99,"description":"Base do IBS/CBS"},"aliquotaIBSEstadual":{"type":"number","multipleOf":0.01,"maximum":99.99,"description":"Alíquota do IBS Estadual"},"valorIBSEstadual":{"type":"number","multipleOf":0.01,"maximum":9999999999.99,"description":"Valor do IBS Estadual"},"aliquotaIBSMunicipal":{"type":"number","multipleOf":0.01,"maximum":99.99,"description":"Alíquota do IBS Municipal"},"valorIBSMunicipal":{"type":"number","multipleOf":0.01,"maximum":9999999999.99,"description":"Valor do IBS Municipal"},"aliquotaCBS":{"type":"number","multipleOf":0.01,"maximum":99.99,"description":"Alíquota do CBS"},"valorCBS":{"type":"number","multipleOf":0.01,"maximum":9999999999.99,"description":"Valor do CBS"},"cClassTribIBSCBS":{"type":"string","maxLength":6,"description":"cClassTrib do IBS/CBS"},"cstIBSCBS":{"type":"string","maxLength":3,"description":"CST do IBS/CBS"},"valorBaseIS":{"type":"number","multipleOf":0.01,"maximum":9999999999.99,"description":"Base Cálculo do IS"},"aliquotaIS":{"type":"number","multipleOf":0.01,"maximum":99.99,"description":"Alíquota do IS"},"valorIS":{"type":"number","multipleOf":0.01,"maximum":9999999999.99,"description":"Valor do IS"},"dadosCustomizados":{"type":"array","items":{"$ref":"#/components/schemas/DadosCustomizados"}}}},"DadosCustomizados":{"type":"object","required":["campo","valor"],"properties":{"campo":{"type":"string"},"valor":{"type":"string"}}},"duplicatasDocumentoFiscal":{"type":"object","description":"Não Repassar esses dados caso a nota esteja Cancelada.","required":["sequenciaDuplicata","valorParcela","quantidade"],"properties":{"sequenciaDuplicata":{"type":"integer","minimum":1,"maximum":999,"description":"Sequência da duplicata"},"valorParcela":{"type":"number","maximum":999999999.99,"multipleOf":0.01,"description":"Valor da parcela"},"dataVencimento":{"type":"string","format":"date","description":"Data de vencimento (YYYY-MM-DD)"},"codRecebimento":{"type":"integer","description":"Código do tipo de recebimento (1 – Dinheiro, 2 – Cheque, 3 – Cartão)","enum":[1,2,3]},"codOperadoraCartao":{"type":"integer","minimum":1,"maximum":99,"description":"Código da operadora do cartão"},"codPortador":{"type":"integer","minimum":1,"maximum":9999,"description":"Código do portador"},"tipoCobranca":{"type":"integer","minimum":1,"maximum":99,"description":"Tipo de cobrança"},"numBancario":{"type":"string","maxLength":20,"description":"Número bancário"},"carteira":{"type":"string","maxLength":3,"description":"Carteira"},"contaBancaria":{"type":"string","maxLength":10,"description":"Conta bancária"},"dadosCustomizados":{"type":"array","items":{"$ref":"#/components/schemas/DadosCustomizados"}}}}}},"paths":{"/documentoFiscal":{"put":{"summary":"Cadastrar Documento Fiscal","description":"","operationId":"CadastrarDocumentoFiscal","tags":["Documento Fiscal"],"responses":{"200":{"description":"OK"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Erro"}}}}},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"parameters":[{"name":"empresa","in":"header","description":"Loja para Importação do Documento Fiscal","required":true,"schema":{"type":"integer","minimum":1,"maximum":99999}}],"requestBody":{"description":"Dados do Documento Fiscal","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaDocumentoFiscalPut"}}}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ajuda.consistem.com.br/consistem-api/consistem-erp-api/comercial/loja-v1.0/documento-fiscal.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.