FacturamaCFDI

Descripción

Crea y timbra un Comprobante Fiscal Digital por Internet (CFDI) versión 4.0 ante el SAT de México a través de Facturama. El nodo genera el UUID fiscal y el XML sellado requeridos por la normativa mexicana.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credenciales de la cuenta Facturama
expedition_place	text	Sí	Código postal del domicilio fiscal del emisor
payment_form	select	No	Forma de pago SAT (default: 03=Transferencia)
payment_method	select	No	PUE=Una exhibición, PPD=Parcialidades (default: PUE)
currency	select	No	MXN, USD, EUR (default: MXN)
serie	text	No	Serie del comprobante (ej: FA)
folio	text	No	Folio (Facturama lo genera si no se indica)
observations	text	No	Observaciones del comprobante
receiver	object	Sí	Objeto JSON con datos del receptor
items	array	Sí	Array JSON con los conceptos del CFDI

Credenciales

Requiere una credencial de tipo facturama con:

• Usuario: usuario de la cuenta en facturama.mx
• Contraseña: contraseña de la cuenta
• Entorno: sandbox (pruebas) o production (SAT real)

Estructura del receptor

{
  "Rfc": "XAXX010101000",
  "Name": "PÚBLICO EN GENERAL",
  "CfdiUse": "S01",
  "FiscalRegime": "616",
  "TaxZipCode": "06600"
}

Valores comunes:

• CfdiUse: S01=Sin efectos fiscales, G01=Adquisición mercancías, G03=Gastos en general
• FiscalRegime: 601=General de Ley, 603=Personas morales fines no lucrativos, 616=Sin obligaciones fiscales

Para público en general usar RFC XAXX010101000 y régimen 616.

Estructura de conceptos (items)

[
  {
    "ProductCode": "81112100",
    "IdentificationNumber": "SERV-001",
    "Description": "Servicio de desarrollo de software",
    "Unit": "Actividad",
    "UnitCode": "E48",
    "UnitPrice": 1000.00,
    "Quantity": 1,
    "Subtotal": 1000.00,
    "Taxes": [
      {
        "Total": 160.00,
        "Name": "IVA",
        "Base": 1000.00,
        "Rate": 0.16,
        "IsRetention": false
      }
    ],
    "Total": 1160.00
  }
]

El ProductCode es el código del catálogo SAT de productos y servicios.

Salida

{
  "success": true,
  "cfdi_id": "abc123def456",
  "uuid": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "serie": "FA",
  "folio": "1001",
  "status": "active",
  "raw": { ... }
}

Ejemplo de Uso

{
  "credentials_id": "cred-facturama-prod",
  "expedition_place": "06600",
  "serie": "FA",
  "payment_form": "03",
  "payment_method": "PUE",
  "currency": "MXN",
  "receiver": {
    "Rfc": "ABCD900101XXX",
    "Name": "Empresa Cliente SA de CV",
    "CfdiUse": "G03",
    "FiscalRegime": "601",
    "TaxZipCode": "64000"
  },
  "items": [
    {
      "ProductCode": "81112100",
      "Description": "Consultoría en TI",
      "Unit": "Actividad",
      "UnitCode": "E48",
      "UnitPrice": 5000.00,
      "Quantity": 1,
      "Subtotal": 5000.00,
      "Taxes": [{ "Total": 800.00, "Name": "IVA", "Base": 5000.00, "Rate": 0.16, "IsRetention": false }],
      "Total": 5800.00
    }
  ]
}

Notas

• El UUID del CFDI es el identificador único ante el SAT — debe guardarse para cancelaciones y descargas
• La autenticación es HTTP Basic (usuario/contraseña de la cuenta facturama.mx)
• En sandbox las facturas no tienen validez fiscal pero son útiles para pruebas de integración

Nodos Relacionados

• FacturamaCancelar - Cancelar un CFDI
• FacturamaDescargar - Descargar XML o PDF