Documentación para integración con servicios Sovos
Inicio

Registro de RFC para el servicio de timbre

Reachcore ha creado un API Rest para el registro de los RFC para el servicio de timbrado.

Contenido

Características generales

Antes de poder timbrar por medio del servicio de Reachcore, es necesario registrar y aprobar el RFC emisor dentro de la plataforma. Para esto, es necesario asociar a cada RFC emisor una dirección de correo electrónico, ya que a esta llegará una notificación con las instrucciones para llevar a cabo el proceso de autorización.

¿Qué necesito?

  • Utilizar los servicios con Reachcore para timbrar comprobantes fiscales.
  • Generar un API Key en tu cuenta Reachcore, ya que se usa para autenticar la solicitud en el API Rest. El API Key debe corresponder al ambiente en el que se realiza la solicitud. Para referencia de como generar el API Key, consulta el siguiente artículo: Generar API Key para Web Services.

Ubicación del servicio

Para registrar un RFC con el cual se puedan llevar a cabo operaciones de timbrado dentro de Reachcore, se debe enviar al API Rest lo siguiente:

Ambiente URL
Piloto https://oat.reachcore.com/api/rest/Timbre/rfc
Producción https://go.reachcore.com/api/rest/Timbre/rfc


Todas las solicitudes se deberán hacer por httpS. Las conexiones realizadas por http serán rechazadas

Verbo HTTP: POST

Encabezado HTTP

Parámetro Valor Uso Descripción
RCApiKey API Key Requerido Autenticación al servicio por medio del API Key generado en la plataforma de Reachcore.
Content-Type application/json Requerido El API Rest solo procesa estructuras Json, por la cual se debe declarar.

Cuerpo

Solo se acepta la estructura de un JSON en el cuerpo del la petición. Solo se debe de enviar los siguientes atributos:

Atributo Uso Descripción
RFC Requerido Indica el valor del RFC a registrar. Debe cumplir con la siguiente expresión regular: [A-Z,Ñ,&]{3,4}[0-9]{2}[0-1][0-9][0-3][0-9][A-Z,0-9]?[A-Z,0-9]?[0-9,A-Z]?
Correo Requerido Establece la dirección de correo electrónico de quién autorizará el uso del RFC que se esta registrando.
RazonSocial Opcional Establece el nombre de la razón social del RFC que se está registrando.


Ejemplo

{
    "RFC": "AAA010101AAA",
    "Correo": "timbre@mail.com",
    "RazonSocial": "Razón social del RFC: AAA010101AAA"
}

Códigos de respuesta

Como respuesta del servicio Rest, obtendrá un código indicando el resultado de la operación. Todas las repuestas son en formato Json (application/json)

Código HTTP Código error Significado Descripción
200 -- OK El RFC se registró correctamente.
400 400-001 Bad request El RFC no es válido
400 400-002 Bad request El correo electrónico no es válido
400 400-003 Bad request El RFC no se encontró en la lista de contribuyentes obligados (LCO)
401 -- Unauthorized El API Key no es válido.
404 -- Not Found La URL no existe
500 -- Internal Server Error Error de la plataforma Reachore


Ejemplo de respuesta con un registro exitoso

{
    "Autorizado": false,
    "Correo": "timbre@mail.com",
    "FechaAutorizacion": null,
    "FechaRegistro": "2016-07-22T12:20:59.1968383-05:00",
    "Habilitado": true,
    "RFC": "HEZD850613C22",
    "RazonSocial": null
}

Ejemplo de una respuesta con errores

{
    "errors": [
        {
            "errorCode": "400-001",
            "errorMessage": "El RFC  no es válido"
        },
        {
            "errorCode": "400-002",
            "errorMessage": "El correo electrónico timbremail.com no es válido"
        },
        {
            "errorCode": "400-003",
            "errorMessage": "El RFC  no fue encontrado en la lista de LCO"
        }
    ]
}

Para mayor información o aclaración de dudas relacionadas con esta guía, por favor envía un correo a MEX-soporte@sovos.com


Regresar