FelEmitirNota

Descripción

Emite una Nota de Crédito (NCRE) o una Nota de Débito (NDEB) como DTE en Guatemala bajo el régimen FEL de la SAT. La nota siempre referencia al documento de origen (típicamente la factura emitida con felEmitirFactura) mediante su UUID.

El nodo arma el DTE de la nota, opcionalmente lo firma con el certificado del emisor y lo envía al certificador habilitado para que la certifique ante el SAT, devolviendo un nuevo UUID propio de la nota.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial FEL
nota	json	No	Nota (JSON): tipo (NCRE/NDEB), receptor, items, referencia {uuid, serie, numero, fecha, motivo} del documento de origen. Si se omite, se toma del data de entrada

Credenciales

Este módulo requiere una credencial de tipo fel (certificador, usuario/clave o llave del certificador, NIT del emisor, certificado .p12 opcional, ambiente).

Salida

{
  "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "tipo": "NCRE",
  "estado": "certified",
  "serie": "A",
  "numero": "205",
  "referencia": { "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" },
  "total": 1120.5,
  "xml": "<...>"
}

Ejemplo de Uso

{
  "credentials_id": "cred-fel-prod",
  "nota": {
    "tipo": "NCRE",
    "receptor": {
      "nit": "CF",
      "nombre": "Consumidor Final"
    },
    "items": [
      {
        "cantidad": 1,
        "descripcion": "Devolución de servicio",
        "precioUnitario": 1120.5,
        "bienOServicio": "S"
      }
    ],
    "referencia": {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "motivo": "Anulación parcial del servicio"
    }
  }
}

Notas

• El campo tipo acepta NCRE (nota de crédito), NDEB (nota de débito) o NABN; si se omite, por defecto es NCRE.
• La nota es rechazada si no incluye referencia.uuid (o referencia.numeroAutorizacion) del documento de origen.
• Igual que en felEmitirFactura, si no se carga certificado propio en la credencial, el certificador firma la nota por vos.
• El uuid devuelto es distinto al del documento de origen: identifica a la nota, no a la factura referenciada.

Nodos Relacionados

• FelEmitirFactura - Emitir la factura de origen
• FelAnular - Anular un DTE ya certificado
• FelRepresentación - Generar la representación impresa con QR