Clientes

Los clientes representan al receptor de sus facturas. Almacene sus datos fiscales una vez y reutilicelos en todas sus facturas.

Crear un cliente

curl https://api.facturacion.srs-ngr.com/v1/clientes \
  -u sk_test_xxx: \
  -H "Content-Type: application/json" \
  -d '{
    "organizacion": "org_1a2b3c4d",
    "rfc": "XAXX010101000",
    "nombre": "PUBLICO EN GENERAL",
    "regimen_fiscal": "616",
    "domicilio_fiscal": "06600",
    "uso_cfdi": "S01",
    "correo": "fiscal@ejemplo.com"
  }'

Campos requeridos

Campo	Descripcion	Ejemplo
`organizacion`	ID de su organizacion	`"org_1a2b3c4d"`
`rfc`	RFC del cliente (12 o 13 caracteres)	`"XAXX010101000"`
`nombre`	Razon social (debe coincidir con el registro del SAT)	`"PUBLICO EN GENERAL"`
`regimen_fiscal`	Codigo de regimen fiscal del SAT	`"616"`
`domicilio_fiscal`	Codigo postal (debe coincidir con el registro del SAT)	`"06600"`
`uso_cfdi`	Codigo de uso de CFDI (debe ser compatible con el regimen)	`"S01"`

El uso_cfdi debe ser compatible con el regimen_fiscal del cliente. Las combinaciones incompatibles seran rechazadas por el PAC durante el timbrado.

Listar clientes

curl "https://api.facturacion.srs-ngr.com/v1/clientes?organizacion=org_1a2b3c4d&q=EJEMPLO" \
  -u sk_test_xxx:

El parametro q busca en rfc y nombre.

Actualizar un cliente

curl -X PATCH https://api.facturacion.srs-ngr.com/v1/clientes/cli_abc123 \
  -u sk_test_xxx: \
  -H "Content-Type: application/json" \
  -d '{"nombre": "EMPRESA EJEMPLO SA DE CV", "uso_cfdi": "G03"}'

Eliminar un cliente

curl -X DELETE https://api.facturacion.srs-ngr.com/v1/clientes/cli_abc123 \
  -u sk_test_xxx:

Elimina el cliente de forma logica (soft-delete). No aparecera en los listados, pero las facturas existentes se conservan.

Consulta de catalogos del SAT

Use la API de catalogos para encontrar valores validos:

# Regimenes fiscales
curl https://api.facturacion.srs-ngr.com/v1/catalogos/regimenes_fiscales -u sk_test_xxx:

# Usos de CFDI
curl https://api.facturacion.srs-ngr.com/v1/catalogos/usos_cfdi -u sk_test_xxx:

Facturas Productos