Evento Nominación

El evento de Nominación facilita la asignación de un cliente a una factura que originalmente fue emitida sin datos del comprador (factura a consumidor final).

Tipo de Evento

Para Nominación, el campo tipoEvento debe ser 3

Casos de Uso

Cliente Posterior

Cliente solicita factura después de la venta al mostrador

RUC No Disponible

Cliente no tenía RUC al momento de la compra pero lo obtuvo después

Factura Empresarial

Persona solicita factura a nombre de su empresa posteriormente

¿Cuándo Usar Nominación?

Situación	Usar Nominación	Acción Correcta
Factura sin cliente	Sí	Nominar el cliente
Cliente incorrecto	No	Cancelar (si < 48h) o Nota de Crédito
Agregar datos faltantes	Sí	Nominar con datos completos
Cambiar cliente	No	No se puede, emitir nueva factura

Parámetros del JSON

tipoEvento integer Requerido

Debe ser 3 para Nominación

cdc string Requerido

CDC (Código de Control) de la factura a la cual se asignará el cliente. Es el CDC completo de 44 dígitos

nombre string Requerido

Nombre completo del cliente o razón social

ruc string Requerido

RUC o cédula del cliente

correo string Opcional

Correo electrónico del cliente (puede estar vacío)

Ejemplo de JSON Nominación

Con Correo Electrónico

JSON

{
  "tipoEvento": 3,
  "cdc": "0180065415004005001061322023102511262018791",
  "nombre": "Juan Pérez García",
  "ruc": "4444441-5",
  "correo": "juan.perez@email.com"
}

Sin Correo Electrónico

JSON

{
  "tipoEvento": 3,
  "cdc": "0180065415004005001061322023102511262018791",
  "nombre": "María López Rodríguez",
  "ruc": "3333333-2",
  "correo": ""
}

Ejemplo de Solicitud Completa

JavaScript

const formData = new FormData();

const nominacionData = {
  tipoEvento: 3,
  cdc: "0180065415004005001061322023102511262018791",
  nombre: "Juan Pérez García",
  ruc: "4444441-5",
  correo: "juan.perez@email.com"
};

formData.append('dataJson', JSON.stringify(nominacionData));
formData.append('recordID', 'TU_RECORD_ID');

fetch('https://api.factpy.com/facturacion-api/evento/', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.then(data => {
  if (data.status) {
    console.log('✓ Nominación exitosa:', data.fecha);
    console.log('Cliente asignado correctamente');
  } else {
    console.error('✗ Error:', data.code);
  }
});

Ejemplo cURL

bash

curl -X POST https://api.factpy.com/facturacion-api/evento/ \
  -H "Content-Type: multipart/form-data" \
  -F "dataJson={\"tipoEvento\":3,\"cdc\":\"0180065415004005001061322023102511262018791\",\"nombre\":\"Juan Pérez García\",\"ruc\":\"4444441-5\",\"correo\":\"juan.perez@email.com\"}" \
  -F "recordID=TU_RECORD_ID"

Flujo de Trabajo Típico

text

1. Cliente realiza compra
   └─ Se emite factura sin datos de cliente (consumidor final)

2. Cliente solicita factura a su nombre
   └─ Recopila: Nombre, RUC y Correo

3. Verificar CDC de la factura original
   └─ Obtener CDC de la respuesta de la API al crear factura

4. Enviar evento de nominación
   └─ Con los datos del cliente

5. SIFEN actualiza el documento
   └─ Factura ahora aparece con datos del cliente

6. Cliente puede ver su factura
   └─ En el portal de SIFEN con su RUC