Saltar a contenido

Referencia

  • https://api.csfacturacion.com/validarfc

API REST application/json

Credenciales de contratación vigente mediante Http Basic

Validaciones de RFC

Realizar diferentes tipos de validaciones sobre un RFC mediante la API de Verifica RFC.

Validación LRFC estándar

/validarfc/{rfc} Valida si un RFC es válido y está registrado ante el SAT

Petición

Path Parameters

Parámetro Descripción Tipo
rfc* RFC del contribuyente String
Ejemplo
GET /validarfc/AAA010101AAA HTTP/1.1
Accept: application/json
Authorization: Basic Zm9vOmJhcg==
Host: api.csfacturacion.com

Respuesta

200 RFC Registrado

application/json

Ejemplo
{
    "rfc": "AAA010101AAA",
    "observacion": "De acuerdo a las disposiciones fiscales previstas en la reforma fiscal 2022, el SAT ya no permite realizar la consulta de la LCO y Nomina tal cómo se venía realizando y por el momento ya no podemos seguir ofreciendo esta funcionalidad.",
    "nomina": {
        "SNCF": "0",
        "subContratacion": "0"
    },
    "LCO": true,
    "mensaje": "RFC disponible",
    "estatus": true
}

Scheme

  • rfc: string
    El RFC que fue consultado
  • observacion: string
    Parrafo que indica porque ya no es posible la consulta de Nomina y LCO (en este endpoint)
  • mensaje: string
    Mensaje descriptivo de la consulta
  • estatus: boolean
    Indica si el RFC está registrado en el SAT
200 RFC no registrado

Tipo

application/json

Cuerpo

Ejemplo
{
    "rfc": "AAA010101AAB",
    "observacion": "De acuerdo a las disposiciones fiscales previstas en la reforma fiscal 2022, el SAT ya no permite realizar la consulta de la LCO y Nomina tal cómo se venía realizando y por el momento ya no podemos seguir ofreciendo esta funcionalidad.",
    "nomina": {
        "SNCF": "0",
        "subContratacion": "0"
    },
    "LCO": true,
    "mensaje": "RFC no disponible",
    "estatus": false
}

Scheme

  • rfc: string
    El RFC que fue consultado
  • observacion: string
    Parrafo que indica porque ya no es posible la consulta de Nomina y LCO (en este endpoint)
  • mensaje: string
    Mensaje descriptivo de la consulta
  • estatus: boolean
    Indica si el RFC está registrado en el SAT
401 Sin Credenciales

Tipo

application/json

Cuerpo

Ejemplo
{
    "error": "debes especificar los headers de autenticacion requerido"
}

Schema

  • error: String
    Resumen/descripción del error

Validación LRFC extendida

/validarfc/v2 Valida RFC con atributos adicionales

Petición

Query String

Parámetro Descripción Requerido Tipo
rfc* RFC del contribuyente Sí String
nombre* Razón social del contribuyente Sí String
domicilio_fiscal* Código postal a validar Sí String
regimen_fiscal Régimen fiscal a validar Cuando se especifica uso_cfdi String
uso_cfdi Uso de CFDI a validar en conjunto Cuando se especifica regimen_fiscal String
Ejemplo
GET /validarfc/v2?rfc=AAA010101AAA&nombre=FOO&domicilio_fiscal=010101&regimen_fiscal=612&uso_cfdi=G03 HTTP/1.1
Accept: application/json
Authorization: Basic Zm9vOmJhcg==
Host: api.csfacturacion.com

Respuesta

200 OK

application/json

Ejemplo
{
    "codigo": "000",
    "descripcion": "Todos los campos son correctos"
}
200 Validación Fallida

application/json

Ejemplo
{
    "codigo": "902",
    "descripcion": "Nombre inválido. (Razón Social)"
}

Códigos de Respuesta

Código Descripción
000 Todos los campos son correctos
902 Nombre inválido. (Razón Social)
903 Residencia fiscal inválida
905 RFC inválido
906 Régimen fiscal inválido de acuerdo al uso de CFDI
301 Error no considerado
401 Sin Credenciales

Tipo

application/json

Cuerpo

Ejemplo
{
    "error": "debes especificar los headers de autenticacion requerido"
}

Schema

  • error: String
    Resumen/descripción del error

Validación LCO

/validarfc/lco Valida si un RFC se encuentra en LCO

Petición

Tipo

application/json

Cuerpo

Campo Descripción Tipo Requerido
rfc* RFC del contribuyente String Sí
nombre* Razón social del contribuyente String Sí
domicilio_fiscal* Código postal a validar String Sí
regimen_fiscal* Régimen fiscal a validar String Sí
Ejemplo
POST /validarfc/lco HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Basic Zm9vOmJhcg==
Host: api.csfacturacion.com
Content-Length: 89

{
    "rfc": "AAA010101AAA",
    "nombre": "FOO",
    "domicilio_fiscal": "010101",
    "regimen_fiscal": "612"
}

Respuesta

200 RFC sin registro en LCO

application/json

Ejemplo
{
    "lco": false
}
200 RFC en LCO

application/json

Ejemplo
{
    "lco": true
}
422 Datos Inválidos

Tipo

application/json

Cuerpo

Ejemplo
{
    "error": "foo bar"
}

Schema

  • error: String
    Resumen/descripción del error
401 Sin Credenciales

Tipo

application/json

Cuerpo

Ejemplo
{
    "error": "debes especificar los headers de autenticacion requerido"
}

Schema

  • error: String
    Resumen/descripción del error