Solución Factible®:Integration Center [SF:IC]

Método: obtenerDatos

El método obtenerDatos del Webservice CFDI busca los datos de un CFDI por folio y serie o por folio fiscal (UUID) y los retorna.

1. Los atributos marcados en cursiva ( italic ) no necesitan ser enviados por el Webservice, se generan o se obtienen de otra fuente en el servidor.
2. Para las búsquedas donde se piden folio (comercial), uuid (folio fiscal) y serie, es obligatorio que se proporcione el folio comercial y la serie o bien el folio fiscal.
3. La obligatoriedad de los campos está representada de la siguiente manera en la columna “Requerido”:
   • Sí: el valor de este campo debe enviarse siempre.
   • No: el valor de este campo puede enviarse o no.
   • Condicional: el valor de este campo puede ser obligatorio o no, dependiendo de otros.

Parámetros:

Nombre	Descripción	Requerido
usuario	xs:string Nombre de usuario registrado para el uso del WebService.	Sí
password	xs:string Contraseña del usuario.	Sí
uuid	xs:string Folio fiscal del CFDI.	Condicional
folio	xs:long Folio comercial del CFDI	Condicional
serie	xs:string Serie del CFDI	Condicional

Ejemplo de petición

Descargar este ejemplo

Regresa

Este método retorna un tipo compuesto: RespuestaCFDI los atributos se describen en la siguiente tabla.

Atributos de RespuestaCFDI

Nombre	Descripción	Requerido
status	xs:int El código estatus de la operación, para detalle de los códigos de estatus consulte “Códigos de respuesta generales de encabezado”	Sí
mensaje	xs:string El mensaje de respuesta, detalla el estatus de la operación.	Sí
comprobantes	Arreglo de CFDI	Sí

Atributos de CFDI

Los atributos marcados en cursiva ( italic ) no necesitan ser enviados por el Webservice, se generan o se obtienen de otra fuente en el servidor.

Nombre	Descripción	Requerido
folio	xs:long El folio comercial del CFDI.	Condicional
nombreSerie	xs:string El nombre de la serie de CFDI.	Condicional
etiquetaComprobante	xs:string Indica de que tipo es el CFDI (ej: Factura, Prefactura, Nota de Crédito).	Sí
nombreEmisor	xs:string Razón social de quién emite el CFDI.	Sí
rfcEmisor	xs:string R. F. C. del emisor.	Sí
calleFiscalEmisor	xs:string Calle del domicilio fiscal del emisor.	Sí
numeroExteriorFiscalEmisor	xs:string Número exterior del domicilio fiscal del emisor.	Sí
numeroInteriorFiscalEmisor	xs:string Número interior del domicilio fiscal del emisor.	No
coloniaFiscalEmisor	xs:string Colonia del domicilio fiscal del emisor.	No
ciudadFiscalEmisor	xs:string Ciudad donde se encuentra el domicilio fiscal del emisor.	No
referenciaFiscalEmisor	xs:string Rasgo geográfico útil para ubicar el domicilio fiscal del emisor.	No
municipioFiscalEmisor	xs:string Municipio dónde se encuentra el domicilio fiscal del emisor.	No
estadoFiscalEmisor	xs:string Estado dónde se encuentra el domicilio fiscal del emisor.	No
paisFiscalEmisor	xs:string País dónde se encuentra el domicilio fiscal del emisor.	No
codigoPostalFiscalEmisor	xs:string Código postal del domicilio fiscal del emisor.	No
calleExpedicionEmisor	xs:string Calle del domicilio de expedición del emisor.	No
numeroExpedicionEmisor	xs:string Número exterior del domicilio de expedición del emisor.	No
numeroInteriorExpedicionEmisor	xs:string Número interior del domicilio de expedición del emisor.	No
coloniaExpedicionEmisor	xs:string Colonia del domicilio de expedición del emisor.	No
ciudadExpedicionEmisor	xs:string Ciudad donde se encuentra el domicilio de expedición del emisor.	No
referenciaExpedicionEmisor	xs:string Rasgo geográfico útil para ubicar el domicilio de expedición del emisor.	No
municipioExpedicionEmisor	xs:string Municipio dónde se encuentra el domicilio de expedición del emisor.	No
estadoExpedicionEmisor	xs:string Estado dónde se encuentra el domicilio de expedición del emisor.	No
paisExpedicionEmisor	xs:string País dónde se encuentra el domicilio de expedición del emisor.	No
codigoPostalExpedicionEmisor	xs:string Código postal del domicilio de expedición del emisor.	No
nombreCliente	xs:string Razón social del receptor de la factura	Sí
rfcCliente	xs:string R. F. C. del receptor.	Sí
emailCliente	xs:string Dirección electrónica del receptor.	No
calleFiscalEmisor	xs:string Calle del domicilio fiscal del receptor.	No
numeroExteriorFiscalCliente	xs:string Número exterior del domicilio fiscal del receptor.	No
numeroInteriorFiscalCliente	xs:string Número interior del domicilio fiscal del receptor.	No
coloniaFiscalCliente	xs:string Colonia del domicilio fiscal del receptor.	No
ciudadFiscalCliente	xs:string Ciudad donde se encuentra el domicilio fiscal del receptor.	No
referenciaFiscalCliente	xs:string Rasgo geográfico útil para ubicar el domicilio fiscal del receptor.	No
municipioFiscalCliente	xs:string Municipio dónde se encuentra el domicilio fiscal del receptor.	No
estadoFiscalCliente	xs:string Estado dónde se encuentra el domicilio fiscal del receptor.	No
paisFiscalCliente	xs:string País dónde se encuentra el domicilio fiscal del receptor.	No
codigoPostalFiscalCliente	xs:string Código postal del domicilio fiscal del receptor.	No
nombreClienteEmbarque	xs:string Nombre de la persona de contacto por parte del receptor del lugar de entrega.	No
rfcClienteEmbarque	xs:string R. F. C. del contacto por parte del receptor del lugar de entrega.	No
calleClienteEmbarque	xs:string Calle del domicilio del lugar de embarque.	No
numeroExteriorClienteEmbarque	xs:string Número exterior del domicilio del lugar de embarque.	No
numeroInteriorEmbarqueCliente	xs:string Número interior del domicilio del lugar de embarque.	No
coloniaEmbarqueCliente	xs:string Colonia del domicilio del lugar de embarque.	No
ciudadEmbarqueCliente	xs:string Ciudad donde se encuentra el domicilio del lugar de embarque.	No
referenciaEmbarqueCliente	xs:string Rasgo geográfico útil para ubicar el domicilio del lugar de embarque.	No
municipioEmbarqueCliente	xs:string Municipio dónde se encuentra el domicilio del lugar de embarque.	No
estadoEmbarqueCliente	xs:string Estado dónde se encuentra el domicilio del lugar de embarque.	No
paisEmbarqueCliente	xs:string País dónde se encuentra el domicilio del lugar de embarque.	No
codigoPostalEmbarqueCliente	xs:string Código postal del domicilio del lugar de embarque.	No
fechaEmision	xs:dateTime Fecha de emisión del CFDI.	Sí
condicionesPago	xs:string Expresa las condiciones comerciales para el pago del CFDI.	No
fechaPago	xs:date Fecha en la que se realizará el pago del CFDI.	Sí
observacionesPago	xs:string Notas sobre el pago de los bienes amparados bajo el CFDI.	No
notasFactura	xs:string Texto libre para añadir notas sobre el CFDI.	No
autorizada	xs:boolean Bandera que indica si el CFDI ha sido autorizado.	Sí
cancelada	xs:boolean Bandera que indica si el CFDI está cancelado.	Sí
xml	xs:base64Binary Arreglo de bytes que conforman el CFDI.	Sí
formaPago	xs:string Precisa la forma de pago que aplica para el CFDI.	Sí
metodoPago	xs:string Expresa el método de pago de los bienes amparados por el CFDI.	No
cadenaOriginal	xs:string Cadena formada por la serie de todos los datos que conforman el CFDI.	Sí
selloDigital	xs:string Cadena que representa la garantía de la vinculación entre la identidad de un sujeto o entidad y su clave pública.	Sí
numeroSerieCsd	xs:string Número de serie del certificado de sello dígital.	Sí
numeroAprobacionSerie	xs:long Número de aprobación de la serie del certificado de sello digital.	Sí
yearAprobacionSerie	xs:long Año en que se aprobo la serie del certificado de sello digital.	Sí
monedaSimbolo	xs:string Símbolo de la moneda que se usa en el CFDI.	No
monedaNombre	xs:string Nombre de la moneda usada en el CFDI.	No
monedaTipoCambio	xs:decimal Tipo de cambio en el que se expresa la moneda usada en el CFDI.	No
subtotal	xs:decimal Cantidad que expresa el subtotal de la suma de los bienes amparados bajo el CFDI.	Sí
importeIva	xs:decimal Monto total de IVA sobre los bienes amparados bajo el CFDI.	Sí
importeIeps	xs:decimal Monto total de IEPS sobre los bienes amparados bajo el CFDI.	Sí
importeRetIva	xs:decimal Monto total de retención de IVA sobre los bienes amparados bajo el CFDI.	Sí
importeRetIsr	xs:decimal Monto total de retención de IEPS sobre los bienes amparados bajo el CFDI.	Sí
importeDescuentos	xs:decimal Monto total de descuento sobre los bienes amparados bajo el CFDI.	No
importeTotal	xs:decimal Monto total que expresa el balance entre el subtotal y los demás importes del CFDI.	Sí
cfdVersion	xs:string Versión del CFDI.	No
tfdVersion	xs:string Versión del timbre fiscal digital.	No
tfdUuid	xs:string Identificador del timbre fiscal digital.	No
tfdCadenaOriginal	xs:string Cadena que contiene todos los elementos que conforman el timbre fiscal digital.	No
tfdSelloDigital	xs:string Garantía de la vinculación entre la identidad de un sujeto o entidad y su clave pública.	No
tfdCertificadoSat	xs:string Número de serie del certificado de sello digital asignado por el provedor autorizado de certificación.	No
detalleCFDI	Arreglo de DetalleCFDI Contiene el detalle de los bienes amparados bajo el CFDI.	Sí
CampoDinamico	Arreglo deCampoDinamico Contiene los datos de los campos dinámicos específicos de una implementación.	Condicional

Atributos del tipo complejo DetalleCFDI

Nombre	Descripción	Requerido
concepto	xs:string Descripción del bien amparado bajo el CFDI.	Sí
unidad	xs:string Unidad de medida en la que se expresa el bien.	Sí
cantidad	xs:decimal Cantidad de bienes expresados bajo el mismo concepto.	Sí
precioUnitario	xs:decimal Valor unitario del bien.	Sí
tasaIva	xs:decimal Tasa unitaria de IVA del bien.	Sí
tasaRetencionIva	xs:decimal Monto de retención de IVA del bien.	No
tasaIeps	xs:decimal Tasa unitaria de IEPS del bien.	No
montoIeps	xs:decimal Monto de IEPS del bien.	No
tasaRentencionIsr	xs:decimal Tasa unitaria de retención ISR del bien.	No
montoRetencionIsr	xs:decimal Monto de retención ISR del bien.	No
tasaDescuento	xs:decimal Tasa de descuento del bien.	No
montoDescuento	xs:decimal Monto de descuento del bien.	No
importe	xs:decimal Importe correspondiente al bien.	Sí
cuentaPredial	xs:string Número de cuenta predial con el que fue registrado el inmueble, en el sistema catastral de la entidad federativa de que trate (solo para bienes inmuebles de un recibo de arrendamiento).	No
codigo	xs:string Código con el que se identifica comercialmente el bien.	No
comment	xs:string Comentario adicional sobre el bien o servicio que se factura.	No
informacionAduanera	Arreglo de InformacionAduanera Información de aduana (aplica solamente cuando el bien es una importación que pasó por aduana).	No

Nota: los datos del emisor se obtienen de la implementación, no se piden.


Atributos del tipo complejo CampoDinamico

Nombre	Descripción	Requerido
campo	xs:string Nombre del campo dinámico.	Sí
valor	xs:string Contiene el valor del campo dinámico.	Sí

Atributos del tipo complejo InformacionAduanera

Nombre	Descripción	Requerido
numeroPedimento	xs:string El número de pedimento correspondiente al bien.	Sí
aduana	xs:string Nombre de la aduana.	Sí
fechaAduana	xs:date La fecha en la que el bien pasó por la aduana.	Sí

Ejemplo de respuesta

Descargar este ejemplo