NFC-e

Registra (o actualiza) una empresa para la emisión de NFC-e. Razón social, IE, dirección y otros datos se extraen automáticamente vía SintegraWS a partir del CNPJ. Si el CNPJ ya existe para el usuario, se actualizan los campos NFC-e y se devuelve la empresa existente.

Headers obligatorios

Body

* Campo obligatorio. Los demás datos (nombre, IE, dirección, etc.) se extraen automáticamente vía SintegraWS desde el CNPJ.

Actualiza la empresa NFC-e identificada por el header token. Todos los campos del body son opcionales — envíe solo los que desee modificar. Al actualizar cep, el sistema resuelve automáticamente stateCode e ibge. Cuando cert_content y cert_pwd vienen juntos, el certificado se valida antes de guardar.

Headers obligatorios

Body (todos los campos opcionales — envíe ≥ 1)

Al menos 1 campo en el body es obligatorio. CNPJ es inmutable.

Devuelve los datos de la empresa NFC-e identificada por el header token. Atención: el método es POST pero no hay campos en el body — la empresa se resuelve solo por el token.

Headers obligatorios

Body

Vacío. Puede enviarse {}.

Crea una categoría fiscal NFC-e. Cada categoría tiene un único escenario (salida interna) y usa objetos planos para ICMS, PIS, COFINS e IBS/CBS (sin array, ya que NFC-e no permite múltiples escenarios por categoría). No incluye IPI.

Headers obligatorios

Body (raíz)

icms

pis / cofins

ibs_cbs (opcional)

* Campo obligatorio.

Devuelve los datos completos de una categoría fiscal NFC-e (descripción, CFOP, ICMS, PIS, COFINS y IBS/CBS).

Headers obligatorios

Query string

* Campo obligatorio.

Devuelve una lista paginada de categorías fiscales NFC-e registradas para la empresa autenticada.

Headers obligatorios

Query string

* Campo obligatorio.

Headers obligatorios

Campo adicional

* Campo obligatorio.

Elimina una categoría fiscal NFC-e. Operación irreversible. Los productos vinculados a esta categoría seguirán referenciando el category_id eliminado — actualícelos primero.

Headers obligatorios

Body

* Campo obligatorio.

Emite una NFC-e (modelo 65, siempre salida interna al estado, sin flete). Diferencias clave respecto al endpoint de NFe: el objeto del consumidor se llama client (no cliente); el número del domicilio es client.number; el consumidor es opcional; no existen impostos.ipi, shipping_address, delivery_address ni transportation. El campo de valor en pag_info se llama amount.

Headers obligatorios

Body (raíz)

client (opcional)

Complete solo si el consumidor está identificado. CPF o CNPJ deben enviarse solo con dígitos.

products[] (cada ítem)

pag_info[] (cada ítem)

* Campo obligatorio. ⚠ category_id o impostos, uno de los dos es obligatorio.

Campos de la respuesta (data)

Respuesta — rechazo / error

        {
          "success": false,
          "data": {
            "uuid": "65f8b9a1c2d3e4f5a6b7c8d9",
            "status": "Failed",
            "motivo": "Rejeição 226: Código da UF do Emitente diverge da UF autorizadora / 拒绝 226: 发件人所在州代码与授权州不一致",
            "nfce": 5,
            "serie": 1,
            "chave": "",
            "modelo": "nfce",
            "xml": "",
            "danfe": ""
          }
        }

Cancela una NFC-e ya autorizada. A diferencia de la NFe, aquí el motivo de la cancelación lo proporciona el cliente y se envía a la autoridad fiscal. La ventana de cancelación en la autoridad fiscal es corta (normalmente 15-30 minutos tras la autorización).

Headers obligatorios

Body

* Campo obligatorio.

Campos de la respuesta (data)

Respuesta — error

        {
          "success": false,
          "data": {
            "motivo": "Rejeição: Pedido de Cancelamento intempestivo",
            "status": "Failed",
            "nfce": 5,
            "serie": 1,
            "chave": "35210112345678901234650010000000051234567890",
            "modelo": "nfce",
            "cStat": 501
          }
        }

Emite la devolución de una NFC-e autorizada. La devolución es una NF-e de entrada (modelo 55) que referencia en su XML la clave de acceso de la NFC-e original; la NFC-e no cuenta con un documento de devolución propio. El documento original se localiza entre los registros de NFC-e por uuid o chave, y los artículos y campos tributarios se toman de él. /api/invoice/return solo busca entre las NF-e y responde "la factura no existe" para cualquier NFC-e; utilice esta ruta.

Headers obligatorios

Body

La devolución es una NF-e y la dirección del destinatario es obligatoria, mientras que la NFC-e normalmente no registra la dirección del comprador. Cuando el XML original no contiene dirección, cliente debe incluir endereco, bairro, city, uf y cep; la ruta indica cuáles faltan.

Solo puede devolverse una NFC-e autorizada. El entorno (producción o pruebas) sigue al del documento original y no se envía como parámetro.

Las llamadas repetidas no emiten dos veces: si ya existe una devolución para el mismo original en el mismo entorno, se devuelve ese documento.

La devolución es total. Los artículos, cantidades y campos tributarios provienen del original; los tributos se resuelven primero por la categoría fiscal y, a falta de ella, se copian del CST y las alícuotas del XML original.

Campos de la respuesta (data)

Respuesta — error

        {
          "success": false,
          "message": "A devolução é uma NF-e e exige o endereço do comprador; a NFC-e original não o traz. Informe em cliente: endereco, bairro, city, uf, cep / 退货票是 NF-e，必须有买方地址，原 NFC-e 没有。请在 cliente 里传：endereco、bairro、city、uf、cep"
        }

Devuelve los detalles de una NFC-e específica por UUID. Incluye URLs del XML y del DANFE (cupón térmico), además de los datos del cliente cuando se proporcionan.

Headers obligatorios

Query string

* Campo obligatorio.

Devuelve la URL del DANFE NFC-e (cupón fiscal electrónico) en PDF, con código QR para consulta en la autoridad fiscal. Generación bajo demanda con caché por hash (clave + estado); las llamadas repetidas devuelven la URL existente.

Headers obligatorios

Body

* Campo obligatorio.

Lista las NFC-e de la empresa con paginación. Los parámetros se pasan por query string (no en el body). El filtro de tiempo es opcional, pero si se envía requiere tanto start_create_time como end_create_time.

Headers obligatorios

Query string

* Campo obligatorio.

Exporta en lote las NFC-e de producción de la empresa por período (las notas de homologación no entran). La generación es asíncrona: la primera llamada dispara la exportación y responde "status": "Processing"; repita la misma llamada (mismo body) hasta recibir "status": "Success" con la url de descarga. XML y PDF salen en .zip (un archivo por nota); la planilla sale en .xlsx o .csv. El resultado vale por 10 días: en ese plazo, los mismos parámetros devuelven el mismo archivo (las notas emitidas después de la generación no entran — use otro período para generar un archivo nuevo).

Headers obligatorios

Body

* Campo obligatorio. Informe el período con start_create_time + end_create_time o con month.