Clientes

¿Para qué sirve el catálogo de clientes?

El catálogo de clientes almacena los datos fiscales de quienes reciben tus facturas. Aunque puedes enviar los datos del receptor directamente en cada CFDI, usar el catálogo te permite:

Reutilizar datos sin repetirlos en cada factura
Validar el RFC del cliente contra la base del SAT
Buscar clientes por nombre o RFC

Crear un cliente

POST /Client

Body

{
  "Rfc": "",
  "Name": "",
  "FiscalRegime": "",
  "Email": "",
  "EmailOp1": "",
  "CfdiUse": "",
  "TaxResidence": "",
  "NumRegIdTrib": "",
  "TaxZipCode": "",
  "Address": {
    "Street": "",
    "ExteriorNumber": "",
    "InteriorNumber": "",
    "Neighborhood": "",
    "ZipCode": "",
    "Locality": "",
    "Municipality": "",
    "State": "",
    "Country": ""
  }
}

string

requerido

RFC del receptor del comprobante fiscal.

string

requerido

Nombre o razón social del receptor.

string

requerido

Clave del régimen fiscal del receptor.

string

requerido

Correo electrónico principal del receptor.

string

Correo electrónico adicional del receptor.

string

requerido

Clave del uso de CFDI que tendrá el comprobante.

string

Clave del país de residencia fiscal del propietario.

string

Número de registro de identificación tributaria del propietario.

string

requerido

Código postal del domicilio fiscal del receptor.

object

Domicilio del receptor.

Mostrar Propiedades

string

Calle del domicilio.

string

Número exterior del domicilio.

string

Número interior del domicilio.

string

Colonia o asentamiento del domicilio.

string

Código postal del domicilio.

string

Localidad del domicilio.

string

Municipio o alcaldía del domicilio.

string

Estado del domicilio.

string

País del domicilio.

JSON de ejemplo

{
  "Rfc": "URE180429TM6",
  "Name": "UNIVERSIDAD ROBOTICA ESPAÑOLA",
  "FiscalRegime": "601",
  "Email": "correo1@ejemplo.mx",
  "EmailOp1": "correo2@ejemplo.com",
  "CfdiUse": "G01",
  "TaxResidence": "",
  "NumRegIdTrib": "",
  "TaxZipCode": "86991",
  "Address": {
    "Street": "Calle de Pruebas",
    "ExteriorNumber": "123",
    "InteriorNumber": "456",
    "Neighborhood": "Colonia de Pruebas",
    "ZipCode": "86991",
    "Locality": "",
    "Municipality": "",
    "State": "TABASCO",
    "Country": "Mex"
  }
}

Ejemplo de Respuesta

{
  "Id": "GQSinri92qqz4cWFAoqKew2",
  "Address": {
    "Street": "Calle de Pruebas",
    "ExteriorNumber": "123",
    "InteriorNumber": "456",
    "Neighborhood": "Colonia de prueba",
    "ZipCode": "86991",
    "Locality": "SAN LUIS POTOSI",
    "Municipality": "SAN LUIS POTOSI",
    "State": "SAN LUIS POTOSI",
    "Country": "MEXICO"
  },
  "Rfc": "URE180429TM6",
  "Name": "UNIVERSIDAD ROBOTICA ESPAÑOLA",
  "FiscalRegime": "601",
  "Email": "correo1@ejemplo.mx",
  "EmailOp1": "correo2@ejemplo.com",
  "CfdiUse": "G01",
  "TaxResidence": "",
  "NumRegIdTrib": "131494-1055",
  "TaxZipCode": "86991"
}

Consultar clientes

Lista solo los 100 primeros registros

GET /Client

Lista paginada

GET /clients?start=0&length=100&search=

string

Posición del registro

string

Tamaño del resultado, valor esperado de (1 a 100)

string

Texto o palabra clave para buscar

Consultar por Id

GET /Client/{Id}

string

requerido

Identificador unico del cliente

Actualizar un cliente

PUT /Client/{Id}

Envía el objeto completo del cliente con los campos modificados.

Eliminar un cliente

DELETE /Client/{Id}

Eliminar un cliente del catálogo no afecta los CFDIs ya emitidos.

RFC genéricos

Tipo	RFC
Público en general (nacional)	`XAXX010101000`
Extranjero	`XEXX010101000`

Primeros pasos

El sistema de facturación en México

API Web

API Multiemisor

CFDI 4.0

Complementos

Catálogos SAT

Herramientas

¿Para qué sirve el catálogo de clientes?

Crear un cliente

Consultar clientes

Lista paginada

Consultar por Id

Actualizar un cliente

Eliminar un cliente

RFC genéricos

​¿Para qué sirve el catálogo de clientes?

​Crear un cliente

​Consultar clientes

​Lista paginada

​Consultar por Id

​Actualizar un cliente

​Eliminar un cliente

​RFC genéricos

¿Para qué sirve el catálogo de clientes?

Crear un cliente

Consultar clientes

Lista paginada

Consultar por Id

Actualizar un cliente

Eliminar un cliente

RFC genéricos