Facturar en Lnea

API DE TIMBRADO FEL 2015

El Manual de Timbrado FEL, contiene la descripcin del servicio, mtodos y
respuestas del mismo. El cual le permitir tener y desarrollar un Software
completo de una manera fcil y amigable.

Versin 2.0

55029

www.fel.mx

Proveedor autorizado de certificacin SAT

Nmero de aprobacin: 55029

Con FEL la Facturacin electrnica

ES MS FCIL

Facturar en Lnea

www.fel.mx
01 800 08 73 391

Manteniendo el mejor sistema

de Timbrado del mercado
Avalados por el SAT, contamos con un excelente proceso de certificacin
y con su apoyo mantendremos esta posicin.

Estimados Usuarios de Timbrado, Desarrolladores y Distribuidores:

Nuestro sistema integral de timbrado ha sido optimizado para asegurar la calidad en el servicio que brindamos
y nuestros usuarios no tendrn ningn problema con los mismos.
que formamos parte de la comunidad FEL.
Realizando un anlisis de performance sobre las peticiones que han hecho algunos de nuestros usuarios de
timbrado, se encontr que se han recibido numerosas peticiones con XMLs errneos, en algunos casos
ms del 80% del total de peticiones por usuario. El rea de tecnologa incluso lleg a catalogar el volumen
de envos errneos como un posible ataque potencial al sistema.
ATENCIN DESARROLLADORES
siguientes puntos:

los desarrolladores debern tomar en cuenta los

Fechas Invlidas
No debern enviar comprobantes con fechas invlidas, debern sincronizar su sistema con la
hora de Mxico Central TIME, en hora, minuto y segundo.
Consulta la hora exacta en el siguiente link: http://www.la-hora.org/reloj_atomico.php

Verificar estndares SAT

Debern revisar la estructura de los archivos XML enviados, y cerciorarse de que cumplen con
todos los estndares marcados por el SAT. Sabemos que otros PAC suelen certificar comprobantes invlidos; sin duda alguna estarn faltando a las normas dispuestas por la autoridad, por
lo que su margen de error ser alto y pondrn en riesgo su autorizacin de certificador oficial.

Eviten ciclos de envo con peticiones invlidas

Si su sistema recibe una respuesta FALSE, tienen que detener la peticin y revisar el error marcado por el sistema. Si un comprobante se marc como invlido la primera vez, evidentemente
las siguientes veces seguir siendo invlido mientras no revisen el error. Si ustedes ciclan sus
procesos de envo estn generando un problema para todos los dems usuarios que hacen
buen uso del servicio de timbrado.
Si el sistema no contesta, entonces es un caso diferente a un XML invlido. En este caso s
debe reintentarse el envo, y una vez restablecida la comunicacin con nuestro sistema, se
procede a validar y timbrar el comprobante.

Con FEL la Facturacin electrnica

Facturar en Lnea

ES MS FCIL

www.fel.mx
01 800 08 73 391

Poltica de margen de error de un 10%

Para proteger el sistema de timbrado se ha establecido una poltica de margen de error de un
10%, es decir, si del global de sus peticiones, menos del 10% generan error, entonces no
tendrn problema para seguir timbrando.
En caso de que su porcentaje sea:
Mayor al 10% del global de peticiones realizadas, se cobrar un timbre por cada peticin
aun cuando sea invlido el archivo XML.
Si sus errores llegan al 30% del global, las cuentas se bloquearn hasta que se pongan en
contacto con el rea de soporte para timbrado.
Muy importante: Es motivo de recesin del contrato de prestacin de servicio, el que un usuario
presente persistentemente un margen de error por encima de los porcentajes indicados.

Estos cambios protegen a todos los usuarios de timbrado y del sistema en lnea. Son polticas que aseguran la calidad que siempre hemos brindado.
Esperamos su comprensin y apoyo, recuerden que esto ayudar a tener mejores desarrollos optimizando
los procesos para todos.

55029

Proveedor autorizado de certificacin SAT

Nmero de aprobacin: 55029

NDICE
1
2

Introduccin
Diagrama de Flujo de Datos

Funciones del Servicio

3
4
5
6
7
8
9
10
11
12
13
14

Timbrar CFDI
Cancelar CFDI
Obtener PDF
Obtener Acuse Envo
Obtener Acuse Cancelacin
Cambiar Password
Consultar Complemento Timbre
Consultar Timbre Por Referencia
Consultar Crditos
Consultar Comprobantes
Cdigos de Error
Anexos

INTRODUCCIN
Facturar en Lnea como Proveedor de Servicios de Expedicin de Comprobante Fiscal Digital a
travs de Internet (PSECFDI), ofrece sus servicios de timbrado conforme a los nuevos requerimientos
especificados para realizar las validaciones de los CFDI exigidos por el SAT.
WSTFD es la plataforma Web Service de FEL para certificar Comprobantes Fiscales Digitales a travs
de Internet. Este servicio de conexin FEL le permitir enviar su XML desde su propio aplicativo (ERP)
y recibir el CFDI y los datos referentes al timbrado para integrarlo a su aplicativo.
La plataforma WSTFD se encuentra desarrollada en VB.net utilizando la tecnologa de Windows Azure.
Windows Azure es una plataforma de computacin en la nube y la infraestructura, creada por Microsoft,
para la construccin, despliegue y gestin de aplicaciones y servicios a travs de una red global de
centros de datos gestionados por Microsoft.
Para acceder a este servicio es necesario ser cliente de FEL ya que se llevar a cabo un proceso de
autenticacin previa a la generacin del comprobante.

WEB SERVICE FEL

El Web Service define diferentes funciones, tanto para generar el Comprobante Fiscal Digital a travs
de internet, as como para Cancelar y otros servicios adicionales ofrecidos por FEL.

Acceso al servicio FEL:

La URL de acceso al Web Service es la siguiente:

https://timbrado.facturarenlinea.com/WSTFD.svc
El WSDL expuesto por este servicio es el siguiente:

https://timbrado.facturarenlinea.com/WSTFD.svc?wsdl
La implementacin del servicio se realizar a travs del protocolo HTTPS, de esta forma, se garantiza
un canal de comunicacin seguro.

Diagrama de flujo de datos

DIAGRAMA DE TIMBRADO

XML

Acuses
p

XML Enviados

p
p

Vlida

*
Monitor
de envo

LOGS
p

TFD

WEB
SERVICE

Base de Datos

Respuesta

CFDI

HSM
p

XML

por enviar

Se enviarn los CFDIs generados al SAT, el cual dar una

respuesta, si es aprobatoria se llevar a cabo la distribucin
a la carpeta correspondiente.

1.1. VALIDACIN
1.2. TIMBRADO
2 CANCELACIN

Diagrama de flujo de datos

DIAGRAMA DE ARQUITECTURA

BASE DE DATOS
p p

WEB
SERVICE

TFD
p

Vlida
p

HSM

Cliente

Timbrar CFDI
Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).
El usuario es responsable de incorporar
correctamente todos los esquemas y requisitos
al XML de acuerdo a la versin ms actual del
Anexo 20 del SAT.
La referencia debe ser nica por cada CFDI.

Descripcin:
La funcin TimbrarCFDI es el mtodo para emitir
el comprobante, si se usa un usuario Productivo,
este se emitir ante el SAT, si se usa un usuario
DEMO, este se emitir nicamente como
prueba, sin validez ante el SAT.

El uso de CSD es obligatorio para personas

morales, mientras las personas fsicas, pueden
optar por usar FIEL o CSD, para sellar sus
comprobantes.
Esta funcin en productivo consume timbres
siempre y cuando la peticin haya sido exitosa o
se haya excedido el 10% de errores. (Consultar
apartado Anexos).

Parmetros:
Parmetro

Uso

usuario

Requerido

password

Requerido

cadena XML

Requerido

referencia

Requerido

Tipo de Dato

Descripcin

String (min12- max13) Usuario FEL que va a realizar la peticin.

String (min 6)

Contrasea de autenticacin del usuario.

String

Contenido del XML con la informacin

del comprobante. Debe cumplir con todos
los requisitos de la versin ms actual de CFDI.

String (min.4)

Referencia que desee asignar el cliente

al CFDI timbrado, que puede ser utilizado
para bsquedas posteriores de sus CFDI.

Validaciones:
Se valida que la estructura del XML cumple con todas las especificaciones del SAT, conforme a la
versin ms actual del Anexo 20.
Se valida que el Certificado de Sello Digital (CSD) o Firma Electrnica Avanzada (FIEL) haya sido
emitido por el SAT.
Que el CSD o FIEL est vigente en la fecha de generacin del comprobante.
Que el CSD o FIEL utilizado para firmar el comprobante, corresponda al emisor del comprobante.
Se valida que el emisor del comprobante se encuentre en la lista LCO.
Se valida que el emisor del comprobante tenga validez de obligaciones en la LCO.
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se verifica que el comprobante no haya sido timbrado previamente.
Se valida que el periodo de tiempo entre la fecha de emisin del comprobante y la fecha de certificacin
no sea mayor a 72 horas.
Se valida que el comprobante no contenga Addendas.
Se verifica que el usuario cuente con timbres disponibles.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaTFD que contiene propieda-

des con informacin til para el usuario, que le permitirn complementar su CFDI y/o actualizar su
informacin.

Propiedad
CodigoRespuesta
MensajeError
MensajeErrorDetallado
OperacionExitosa

Descripcin
Cdigo de confirmacin de peticin (Cotejar con cdigos adjuntos).
Mensaje de error al consumir el servicio
Mensaje detallado sobre el error presentado.
True/False (Resultado de la operacin, True para operacin
exitosa, False para peticin errnea).

PDFResultado
CreditosRestantes

Vaco
En sta propiedad se muestra la cantidad de crditos restantes.

XMLResultado
Timbre

XML timbrado.
Esta propiedad contiene los siguientes atributos:
Propiedad
Estado

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Descripcin
Estado del Comprobante
(Vigente/Cancelado).

FechaTimbrado

Fecha de timbrado del CFDI.

NumeroCertificadoSAT

Nmero del certificado

del PAC que timbr el CFDI.

SelloCFD

Sello emisor del CFDI.

SelloSAT

Sello del PAC que

timbr el CFDI.

UUID

UUID (Folio Fiscal) del CFDI.

Cancelar CFDI
Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).
El servicio de Cancelacin es un servicio que
provee nicamente el SAT, los PAC nos
conectamos a un Web Service del mismo para
realizar la peticin, si el servicio no se encuentra
disponible es por mantenimiento o problemas en
los servicios del SAT.
Se recomienda cancelar tras 24hrs despus de
haber emitido el comprobante.
Esta operacin no se puede revertir.

Descripcin:
La funcin CancelarCFDI te permite realizar la
peticin al SAT de cancelacin de un
comprobante CFDI.

En la lista a cancelar, se puede incluir mnimo

1 UUID hasta mximo 500 en una misma
peticin.
No existen pruebas de cancelacin.
Esta funcin no consume timbres.

Parmetros:
Parmetro

Uso

usuario

Requerido

password

Requerido

rFCEmisor

Requerido

listaCFDI

Requerido

Tipo de Dato
String (min 12 ~ max
- 13)
String (min 6)

Descripcin
Usuario FEL que va a realizar la peticin.
Contrasea de autenticacin del usuario.

String
(min 12 ~ max - 13)

RFC Emisor del CFDI.

String <list>
(min 1 ~ max 200)

Folio Fiscal Digital (UUID) a cancelar.

clavePrivada_Base64

Requerido

String

CertificadoPKCS12
en Base64
Folio
Fiscal Digital (UUID)
a cancelar.
(Consultar gua creacin PFX).

passwordClavePrivada

Requerido

String

Contrasea del PFX de Cancelacin.

Validaciones:
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.
Se valida que sea un UUID que haya sido emitido por FEL.
Se verifica que sea un UUID vlido.
Se valida que el UUID haya sido emitido con el usuario de timbrado.
Se valida que el UUID corresponda al RFC emisor.
Se valida que la listaCFDI contenga al menos 1 UUID.
Se valida que el PFX y contrasea del mismo tengan correspondencia.
Se valida que el PFX generado, corresponda al CSD o FIEL con el cual fue emitido el CFDI.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaCancelacion que contiene
propiedades con informacin til para el usuario, que le permitirn actualizar su informacin.

Propiedad
CodigoRespuesta
MensajeError
MensajeErrorDetallado
OperacionExitosa
XMLAcuse
Detalles Cancelacin

Descripcin
Cdigo de confirmacin de peticin (Cotejar con cdigos adjuntos).
Mensaje de error al consumir el servicio.
Mensaje detallado sobre el error presentado.
True/False (Resultado de la operacin, True para operacin
exitosa, False para peticin errnea).
XML Acuse de cancelacin del SAT.
Es un arreglo de detalle de cancelacin:
ArrayOfDetalleCancelacion

Este arreglo contiene los siguientes atributos:

Propiedad

Descripcin

CodigoResultado

Cdigo de confirmacin
(Cotejar con los cdigos adjuntos).

MensajeResultado

Mensaje de la operacin
de cancelacin al UUID.

UUID

UUID (Folio Fiscal) del CFDI.

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Obtener PDF
Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).
El formato PDF contiene un diseo genrico,
que cumple con los estndares del SAT segn la
RMF vigente.
Es posible colocar un logo al PDF, el cual se
visualizar en la esquina superior izquierda con
un tamao proporcional, si no se requiere logo,
el parmetro debe ir vaco.

Descripcin:
La funcin ObtenerPDF te permite obtener la
representacin impresa del CFDI, en formato
PDF.

Esta funcin no consume timbres.

Parmetros:
Uso

Tipo de Dato

usuario

Requerido

String (min 12 ~ max

- 13)

password

Requerido

String (min 6)

uUID

Requerido

String
(length. 32)

Parmetro

LogoBase64

Opcional

String

Descripcin
Usuario FEL que va a realizar la peticin.
Contrasea de autenticacin del usuario.
Folio Fiscal Digital (UUID) a cancelar.

Logotipo en Base64 para el PDF.

Validaciones:
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.
Se valida que sea un UUID que haya sido emitido por FEL.
Se verifica que sea un UUID vlido.
Se valida que el UUID haya sido emitido con el usuario de timbrado.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaTFD que contiene propiedades con informacin til para el usuario, que le permitirn obtener el PDF en base 64.
Propiedad
CodigoRespuesta
MensajeError
MensajeErrorDetallado
OperacionExitosa

Descripcin
Cdigo de confirmacin de peticin (Cotejar con cdigos adjuntos).
Mensaje de error al consumir el servicio.
Mensaje detallado sobre el error presentado.
True/False (Resultado de la operacin, True para operacin
exitosa, False para peticin errnea).

PDFResultado
CreditosRestantes

PDF en Base64.
En sta propiedad se muestra la cantidad de crditos restantes.

XMLResultado
Timbre

XML timbrado.
Esta propiedad contiene los siguientes atributos:
Propiedad
Estado

Descripcin
Estado del Comprobante
(Vigente/Cancelado).

FechaTimbrado

Fecha de timbrado del CFDI.

NumeroCertificadoSAT

Nmero del certificado

del PAC que timbr el CFDI.

SelloCFD

Sello emisor del CFDI.

SelloSAT

Sello del PAC que

timbr el CFDI.

UUID

UUID (Folio Fiscal) del CFDI.

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Obtener Acuse Envo

Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).
El Acuse de envo, no tiene validez fiscal, se
utiliza nicamente cuando un CFDI despus de
72 horas an no ha sido registrado en los
controles del SAT. En este caso se levanta un
reporte con el SAT con dicho acuse.

Descripcin:
La funcin ObtenerAcuseEnvio te permite
obtener el acuse que el SAT nos da como recibo
que el CFDI fue almacenado correctamente, en
algunos casos resulta til para realizar
aclaraciones ante el SAT.

Parmetros:
Parmetro

Uso

Tipo de Dato
String (min 12 ~ max
- 13)

usuario

Requerido

password

Requerido

String (min 6)

uUID

Requerido

String
(length. 32)

Descripcin
Usuario FEL que va a realizar la peticin.
Contrasea de autenticacin del usuario.
Folio Fiscal Digital (UUID) a cancelar.

Validaciones:
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.
Se valida que sea un UUID que haya sido emitido por FEL.
Se verifica que sea un UUID vlido.
Se valida que el UUID haya sido emitido con el usuario de timbrado.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaTFD que contiene propiedades con informacin til para el usuario, que le permitirn obtener el XML de acuse de envi.

Propiedad
CodigoRespuesta
MensajeError
MensajeErrorDetallado
OperacionExitosa

Descripcin
Cdigo de confirmacin de peticin (Cotejar con cdigos adjuntos).
Mensaje de error al consumir el servicio
Mensaje detallado sobre el error presentado.
True/False (Resultado de la operacin, True para operacin
exitosa, False para peticin errnea).

PDFResultado
CreditosRestantes
XMLResultado
Timbre

Vaco
En sta propiedad se muestra la cantidad de crditos restantes.
XML acuse de envo
Esta propiedad contiene los siguientes atributos:
Propiedad
Estado

Descripcin
Estado del Comprobante
(Vigente/Cancelado).

FechaTimbrado

Fecha de timbrado del CFDI.

NumeroCertificadoSAT

Nmero del certificado

del PAC que timbr el CFDI.

SelloCFD

Sello emisor del CFDI.

SelloSAT

Sello del PAC que

timbr el CFDI.

UUID

UUID (Folio Fiscal) del CFDI.

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Obtener Acuse Cancelacin

Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).

Descripcin:

El Acuse de cancelacin, no tiene validez

fiscal, en raras ocasiones al cancelar un UUID
este no se actualiza en los registros del SAT. En
este caso se levanta un reporte con el SAT con
dicho acuse.

La funcin ObtenerAcuseCancelacion te permite

obtener el acuse que el SAT nos da como recibo
que el CFDI fue cancelado correctamente, en
algunos casos resulta til para realizar
aclaraciones ante el SAT.

Esta funcin no consume timbres.

Parmetros:
Parmetro

Uso

Tipo de Dato
String (min 12 ~ max
- 13)

usuario

Requerido

password

Requerido

String (min 6)

uUID

Requerido

String
(length. 32)

Descripcin
Usuario FEL que va a realizar la peticin.
Contrasea de autenticacin del usuario.
Folio Fiscal Digital (UUID)
del comprobante.

Validaciones:
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.
Se valida que sea un UUID que haya sido emitido por FEL.
Se verifica que sea un UUID vlido.
Se valida que el UUID haya sido emitido con el usuario de timbrado.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaTFD que contiene propiedades con informacin til para el usuario, que le permitirn obtener el XML de acuse de cancelacin.

Propiedad
CodigoRespuesta
MensajeError
MensajeErrorDetallado
OperacionExitosa

Descripcin
Cdigo de confirmacin de peticin (Cotejar con cdigos adjuntos).
Mensaje de error al consumir el servicio
Mensaje detallado sobre el error presentado.
True/False (Resultado de la operacin, True para operacin
exitosa, False para peticin errnea).

PDFResultado
CreditosRestantes
XMLResultado
Timbre

Vaco
En sta propiedad se muestra la cantidad de crditos restantes.
XML acuse de cancelacin.
Esta propiedad contiene los siguientes atributos:
Propiedad
Estado

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Descripcin
Estado del Comprobante
(Vigente/Cancelado).

FechaTimbrado

Fecha de timbrado del CFDI.

NumeroCertificadoSAT

Nmero del certificado

del PAC que timbr el CFDI.

SelloCFD

Sello emisor del CFDI.

SelloSAT

Sello del PAC que

timbr el CFDI.

UUID

UUID (Folio Fiscal) del CFDI.

Cambiar Password
Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).

Descripcin:
La funcin CambiarPassword te permite cambiar
la contrasea de tu usuario de Timbrado FEL.

FEL no tiene acceso a las contraseas de los

usuarios, es importante que si va a ocupar esta
funcin, guarde su nueva contrasea en un lugar
seguro.
Esta funcin no consume timbres.

Parmetros:
Parmetro
usuario

Uso
Requerido

Tipo de Dato
String (min 12 ~ max
- 13)

Descripcin
Usuario FEL que va a realizar la peticin.

passwordActual

Requerido

String (min 6)

Contrasea actual de autenticacin del usuario.

passwordNuevo

Requerido

String (min 6)

Contrasea nueva de autenticacin del usuario.

Validaciones:
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.
Se verifica que la contrasea nueva contenga al menos 6 caracteres.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaTFD que contiene la confirmacin de
la operacin.
Propiedad
CodigoRespuesta
MensajeError
MensajeErrorDetallado
OperacionExitosa

Descripcin
Cdigo de confirmacin de peticin (Cotejar con cdigos adjuntos).
Mensaje de error al consumir el servicio
Mensaje detallado sobre el error presentado.
True/False (Resultado de la operacin, True para operacin
exitosa, False para peticin errnea).

PDFResultado
CreditosRestantes

Vaco
En sta propiedad se muestra la cantidad de crditos restantes.

XMLResultado

Vaco

Timbre

Vaco

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Propiedad

Descripcin

Estado

Vaco

FechaTimbrado

Vaco

NumeroCertificadoSAT

Vaco

SelloCFD

Vaco

SelloSAT

Vaco

UUID

Vaco

Consultar Complemento Timbre

Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).
Esta funcin no consume timbres.

Descripcin:
La funcin ConsultarComplementoTimbre te
permite consultar la informacin del Timbre
Fiscal Digital (TFD) de algn CFDI emitido
posteriormente.

Parmetros:
Parmetro

Uso

Tipo de Dato
String (min 12 ~ max
- 13)

usuario

Requerido

password

Requerido

String (min 6)

UUID

Requerido

String
(length. 32)

Descripcin
Usuario FEL que va a realizar la peticin.
Contrasea de autenticacin del usuario.
Folio Fiscal Digital (UUID)
del comprobante.

Validaciones:
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.
Se valida que sea un UUID que haya sido emitido por FEL.
Se verifica que sea un UUID vlido.
Se valida que el UUID haya sido emitido con el usuario de timbrado.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaTFD que contiene propiedades con informacin til para el usuario, que le permitirn obtener la informacin del complemento TFD.

Propiedad
CodigoRespuesta
MensajeError
MensajeErrorDetallado
OperacionExitosa

Descripcin
Cdigo de confirmacin de peticin (Cotejar con cdigos adjuntos).
Mensaje de error al consumir el servicio
Mensaje detallado sobre el error presentado.
True/False (Resultado de la operacin, True para operacin
exitosa, False para peticin errnea).

PDFResultado
CreditosRestantes

Vaco
En sta propiedad se muestra la cantidad de crditos restantes.

XMLResultado
Timbre

XML Timbrado.
Est propiedad contiene los siguientes atributos:
Propiedad
Estado

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Descripcin
Estado del Comprobante
(Vigente/Cancelado).

FechaTimbrado

Fecha de timbrado del CFDI.

NumeroCertificadoSAT

Nmero del certificado

del PAC que timbr el CFDI.

SelloCFD

Sello emisor del CFDI.

SelloSAT

Sello del PAC que

timbr el CFDI.

UUID

UUID (Folio Fiscal) del CFDI.

Consultar Timbre Por Referencia

Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).

Descripcin:

Esta funcin no consume timbres.

La funcin ConsultarTimbrePorReferencia te
permite consultar la informacin del Timbre
Fiscal Digital (TFD) y el XML de un CFDI emitido
posteriormente.

Parmetros:
Parmetro

Uso

Tipo de Dato

Descripcin

String (min 12 ~ max

- 13)

Usuario FEL que va a realizar la peticin.

usuario

Requerido

password

Requerido

String (min 6)

Contrasea de autenticacin del usuario.

referencia

Requerido

String (min 4)

Referencia con la cual fue emitido el CFDI.

Validaciones:
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.
Se verifica que la referencia se encuentre registrada en los CFDI emitidos por el usuario.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaTFD que contiene propiedades con
informacin til para el usuario, que le permitirn obtener la informacin del complemento TFD y el XML.

Propiedad
CodigoRespuesta
MensajeError
MensajeErrorDetallado
OperacionExitosa

Descripcin
Cdigo de confirmacin de peticin (Cotejar con cdigos adjuntos).
Mensaje de error al consumir el servicio.
Mensaje detallado sobre el error presentado.
True/False (Resultado de la operacin, True para operacin
exitosa, False para peticin errnea).

PDFResultado
CreditosRestantes

Vaco
En sta propiedad se muestra la cantidad de crditos restantes.

XMLResultado
Timbre

XML Timbrado.
Esta propiedad contiene los siguientes atributos:
Propiedad
Estado

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Descripcin
Estado del Comprobante
(Vigente/Cancelado).

FechaTimbrado

Fecha de timbrado del CFDI.

NumeroCertificadoSAT

Nmero del certificado

del PAC que timbr el CFDI.

SelloCFD

Sello emisor del CFDI.

SelloSAT

Sello del PAC que

timbr el CFDI.

UUID

UUID (Folio Fiscal) del CFDI.

Consultar Crditos

Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).
Los paquetes de timbres se activan en automtico y por orden de alta.

Descripcin:
La funcin ConsultarCreditos te permite obtener
una lista detallada de todos los paquetes de
timbres disponibles en el usuario.

Esta funcin no consume timbres.

Parmetros:
Parmetro

Uso

usuario

Requerido

password

Requerido

Tipo de Dato
String (min 12 ~ max
- 13)
String (min 6)

Descripcin
Usuario FEL que va a realizar la peticin.
Contrasea de autenticacin del usuario.

Validaciones:
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaCreditos que contiene propiedades con la
lista de todos los paquetes actual, para el usuario de timbrado.

Propiedad

Descripcin

MensajeError

Mensaje de error al consumir el servicio.

OperacionExitosa

True/False (Resultado de la operacin, True para operacin

exitosa, False para peticin errnea).

Paquetes

Es un arreglo de Detalles de Paquetes de Crditos.

ArrayOfDetallePaqueteCreditos

Este arreglo contiene los siguientes atributos:

Propiedad
EnUso

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Descripcin
True/False (Indica cuando un paquete
de timbres est activado).

FechaActivacion

Fecha de activacin del paquete.

FechaVencimiento

Fecha de vencimiento
del paquete (1 ao a partir de la activacin).

Paquete

Nombre del paquete.

Timbres

Timbres totales del paquete.

TimbresRestantes

Timbres restantes del paquete actual.

TimbresUsados

Timbres usados del paquete actual.

Vigente

True/False (Vigencia del paquete).

Consultar Comprobantes
Consideraciones:
Se requiere de un Usuario de Timbrado FEL
(distinto al usuario FEL En Lnea o Conexin
Remota, si se cuenta con uno).
Esta funcin no puede ser utilizada en principios o finales de mes y se limita a filas por
comprobantes.

Descripcin:
La funcin ConsultarComprobantes te permite
obtener una lista detallada de todos los
comprobantes que fueron emitidos en un lapso
de tiempo.

Esta funcin no consume timbres.

Parmetros:
Parmetro

Uso

Tipo de Dato
String (min 12 ~ max
- 13)

Descripcin

usuario

Requerido

password

Requerido

String (min 6)

fechaInicial

Requerido

Date Time
(yyyy-mm-ddThh:mm:ss)

Fecha inicial del rango de bsqueda.

fechaFinal

Requerido

Date Time
(yyyy-mm-ddThh:mm:ss)

Fecha final del rango de bsqueda.

filaInicial

Requerido

Int (min. 1)

Usuario FEL que va a realizar la peticin.

Contrasea de autenticacin del usuario.

Fila del resultado a consultar.

Validaciones:
Se verifica que el usuario cuente con permiso de acceso al servicio.
Se valida que el usuario sea correcto y que el proceso de autenticacin sea exitoso.
Se valida que la Fecha Inicial sea mayor a la Fecha Final.
Se valida que la Fecha Final no sea menor a la Fecha Inicial.
Se verifica que el mtodo se encuentre disponible.
El periodo mximo es de 7 das naturales entre la fecha de inicial y final de la consulta.

Respuesta:
La respuesta a la peticin se devuelve en un Objeto del tipo RespuestaReporte que contiene propiedades con
la lista de todos los comprobantes encontrados.
Propiedad

Descripcin

MensajeError
OperacionExitosa

Mensaje de error al consumir el servicio.

True/False (Resultado de la operacin, True para operacin
exitosa, False para peticin errnea).

TotalComprobantesPeriodo

Total de comprobantes encontrados en el rango de bsqueda

Lista de Comprobantes

Es un arreglo de registro de Timbre.

ArrayOfRegistroTimbre

Este arreglo contiene los siguientes atributos:

Propiedad

Ejemplos en cdigo:
Descargar en VB.Net
Descargar en C#
Descargar en Java
Descargar en SOAP (Mensaje SOAP)

Descripcin

Estado

Estado del Comprobante

(Vigente/Cancelado).

FechaTimbrado

Fecha de timbrado del CFDI.

NoFila

NoFila del resultado de la bsqueda.

RFCEmisor

RFC Emisor del CFDI.

RFCReceptor

RFC Receptor del CFDI.

UUID

UUID (Folio Fiscal) del CFDI.

* Al consultar los comprobantes slo se podr hacer por un rango de fechas de 7 das naturales.
* Por cada invocacin del mtodo se devolver un mximo de 50 registros.
* Al invocar el mtodo se pide "filaInicial" el cual es un conjunto de 50 registros.
* La cantidad de "filaInicial" es el nmero total de registros en el rango de fechas entre 50.
* ste mtodo es nicamente para verificar el registro de los comprobantes emitidos en un rango de fechas,
no devuelve ni PDF ni XML.
* A continuacin veremos dos ejemplos, uno de un cliente que en 7 das realiz 56 facturas y otro que en los
mismos 7 das realiz 1035.

Ejemplo prctico para un usuario que registr 56 comprobantes en 7 das

Peticin1

Peticin2

fechainicial

24/11/14

24/11/14

fechaFinal

01/12/14

01/12/14

filaInicial

Fila 1 (comprobantes del

1 al 50)

Invocacin

Respuesta
Peticin1
totalComprobantesPeriodo
Lista de comprobantes

Peticin2

56

56

50 Registros

6 Registros

Fila 2
(del 51 al 56)

1
2

24/11/14

3
...
...
...
49
50
51...
56

01/12/14

Ejemplo prctico para un usuario que registr 1035 comprobantes en 7 das

Invocacin
Peticin1

Peticin2

Peticin3

Fila 1

1...50

fechainicial

24/11/14

24/11/14

24/11/14

Fila 2

51..100

fechaFinal

01/12/14

01/12/14

01/12/14

Fila 3

101...150

filaInicial

21

Fila n

Respuesta

totalComprobantesPeriodo
Lista de comprobantes

Peticin1

Peticin2

Peticin3

1035

1035

1035

50 Registros

50 Registros

35 Registros

24/11/14

...

Fila 19

901...950

Fila 20

951...1000

Fila 21

1001...1035

01/12/14

CDIGOS DE ERROR
TIMBRADO
Cdigo

Mensaje

Descripcin

301

XML mal formado

El XML recibido no cumple con los estndares del SAT.

302

Sello mal formado

o invalido

El sello que contiene el XML se gener de manera incorrecta.

303

Sello no corresponde
a emisor o caduco

El XML se sell con un CSD o FIEL que no corresponde

304

Certificado revocado
o caduco

El XML se sell con un CSD o FIEL que se encuentra

con un estatus revocado en la LCO o ya caduc su vigencia.

La fecha de emisin no est dentro

de la vigencia del CSD o
FIEL del emisor.

El XML se sell con un CSD o FIEL que se encuentra

con un estatus revocado en la LCO o ya caduc su vigencia.

305

al RFC Emisor.

306

El certificado no es del tipo CSD

El XML se gener en una fecha fuera del rango

de vigencia del CSD o FIEL segn la LCO.

307

El CFDi contiene un timbre previo

El XML se gener en una fecha fuera del rango de

vigencia del CSD o FIEL segn la LCO.

308

Certificado no expedido por el SAT

El XML se sell con la FIEL.

Aplica nicamente a personas morales.

401

Fecha y hora de generacin

fuera de rango

El XML se gener antes de 72 horas o en una

fecha/hora posterior a la actual.

402

RFC del emisor no se encuentra

en el rgimen de contribuyentes

El RFC del emisor, no se encuentra en la lista LCO.

403

La fecha de emisin no es
posterior al 01 de enero del 2011

La fecha de generacin del XML es menor

al 1 de enero del 2011.

CDIGOS DE ERROR
CANCELACIN
Cdigo
201

Mensaje
UUID Cancelado

Descripcin
Cancelacin exitosa ante el SAT.

202

UUID previamente cancelado

El UUID ya est cancelado en los registros del SAT.

203

UUID no corresponde al Emisor

El UUID enviado para cancelar no corresponde al

204

UUID no aplicable para cancelacin

El UUID no se registr correctamente ante el SAT.

(caso poco probable).

205

UUID no existe.

El UUID no existe en los registros del SAT.

RFC del emisor enviado

CDIGOS DE ERROR
INVOCACIN DEL SERVICIO FEL
Cdigo
800

Mensaje
Operacin exitosa

801

El comprobante ya fue
timbrado por FEL

802

Imposible obtener los

valores para timbrar

803

Imposible generar el complemento TFD

Descripcin
La invocacin al servicio se realiz correctamente.
NO APLICA PARA EL MTODO TIMBRARCFDI

XML timbrado previamente por FEL.

Falla de comunicacin interna del

servicio (caso poco probable).
Falla de comunicacin con el SAT (caso poco probable).

804

Imposible crear registro de

timbrado en base de datos

805

El comprobante contiene
el nodo Addenda

806

Error genrico de
invocacin en el servicio

807

Error de autenticacin de usuario

El usuario no existe o la contrasea es incorrecta.

808

El usuario no cuenta
con permiso de acceso

El usuario existe pero se le revoco el permiso de acceso

por uso indebido del servicio.

809

El paquete de timbres ha expirado

El paquete de timbres adquirido se ha terminado o caduc.

810

Error al consumir el timbre

811

El RFC de usuario no corresponde

al del emisor del CFDi

812

La recepcin del CFDi por parte

del SAT an no se ha concretado

Falla interna del servicio (caso poco probable).

No se puede timbrar un XML que contenga una addenda.
Si se desea manejar, primero se timbra el comprobante,
posteriormente se agrega la addenda.
Alguno de los datos enviados para acceder al
servicio es incorrecto.

No se pudo actualizar la informacin de la peticin

(caso poco probable).
El RFC del emisor del comprobante, no corresponde
al usuario de timbrado.
El PAC an no entrega al SAT el comprobante CFDI
(caso poco probable solo en contingencia).

813

Validacin de certificado
LCO incorrecta

No fue posible verificar Certificado emisor contra lista LCO.

814

No se pudo realizar
el envi del CFDI al SAT

No fue posible enviar en vivo el CFDI al SAT, se entregar

posteriormente mediante monitor. Max. 72hrs.

INVOCACIN DEL SERVICIO FEL

Cdigo
815
816

Mensaje
Ha alcanzado el lmite de intentos
de autenticacin. Intente despus de 30
minutos

No se pudo realizar el envo al SAT

817

Se excedi el nmero
de UUIDs a cancelar

818

El CSD no existe en la LCO

819

Al menos un UUID est

previamente cancelado

820

El UUID no existe
en nuestros registros

Descripcin
Despus de 3 intentos fallidos continuos,
se bloquear al usuario por 30 minutos.
Ocurri un error al tratar de acceder al servicio del
SAT para entregar el CFDI.
Se excedi el lmite del 200 UUID
a cancelar en una misma peticin.
El CSD o FIEL del emisor no
existe en la LCO o es nuevo.
La lista de UUIDs a cancelar,
al menos 1 UUID ya se encuentra cancelado.
El UUID a cancelar, no fue emitido
por FEL o no existe.
An no se concreta el envi
del CFDI al SAT. Max. 72hrs.

821

El UUID se encuentra en
proceso de envi al SAT

822

Error al obtener el acuse de envi

El SAT no dio acuse de recibido del CFDI.

823

Error al obtener el
acuse de cancelacin

El SAT no dio acuse de cancelacin.

824

Contribuyente no tiene
validez de obligaciones

El contribuyente presenta un adeudo

o aclaracin ante el SAT.

825

El UUID an no ha sido cancelado

El CFDI an no ha sido cancelado.

No fue posible extraer el comprobante
de la base de datos.

826

Error al obtener el XML

827

Servicio de cancelacin del SAT

no disponible temporalmente

El servicio de cancelacin del

SAT presenta problemas o mantenimiento.

828

La fecha de elaboracin lmite

para timbrar un CFD v3.0 es
30/Junio/2012

Se intenta timbrar un CFD 3.0

829

Error al obtener el PDF

No fue posible generar el PDF.

830

No es posible procesar
la lista de UUIDs

La lista de UUIDs a cancelar, contiene

datos no vlidos.

831

XML no localizado

No fue posible obtener el XML de la base de datos.

INVOCACIN DEL SERVICIO FEL

Cdigo
832
833

Mensaje
Registro no localizado

No se localiza registro de entrada

14 Anexos:
Manual generacin PFX de cancelacin.
XML de Ejemplo.

Descripcin
El registro solicitado no pudo ser localizado.
El registro de entrada no pudo ser localizado.

Facturar en Lnea

GRACIAS!
Si contina con dudas...
No dude en comunicarse con nosotros va mail:
soportetimbrado@facturarenlinea.com.mx

55029

www.fel.mx

Proveedor autorizado de certificacin SAT

Nmero de aprobacin: 55029