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

Método: obtenerDatos

English version

El método obtenerDatos del Webservice CFDI33 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. La búsqueda puede ser mediante:
   • El uuid (folio fiscal) únicamente o
   • El folio (comercial) y la serie.
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: obtenerDatosResponse los atributos se describen en la siguiente tabla.

Atributos de obtenerDatosResponse

Nombre	Descripción	Requerido
estatus	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í
comprobante	Objeto comprobante Objeto tipo complejo, descrito en la tabla “Atributos del tipo complejo comprobante”.	Sí

Atributos del tipo complejo comprobante

Nombre	Descripción	Requerido
folio	xs:long Número de folio del comprobante. Ejem: 525	Sí
nombreSerie	xs:string Nombre de la serie sobre la que se debe crear el comprobante. Ejem: SJ	Sí
regimenFiscal	xs:string Clave del régimen del contribuyente emisor al que aplicará el efecto fiscal de este comprobante.	Sí
lugarExpedicion	xs:string Código postal del lugar de expedición del comprobante (domicilio de la matriz o de la sucursal).	Sí
formaPago	xs:string Para expresar la clave de la forma de pago de los bienes o servicios amparados por el comprobante. De acuerdo al catálogo del SAT.	Sí
metodoPago	xs:string Para precisar la clave del método de pago que aplica para este comprobante.	Sí
monedaNombre	xs:string Nombre de la moneda. Ejem: Peso Mexicano	Sí
monedaSimbolo	xs:string Clave de la moneda utilizada para expresar los montos, cuando se usa moneda nacional se registra MXN. Conforme con la especificación ISO 4217.	Sí
notas	xs:string Notas del comprobante.	Sí
etiquetaComprobante	xs:string Indica de que tipo es el CFDI (ej: Factura, Prefactura, Nota de Crédito).	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í
cadenaOriginal	xs:string Cadena formada por la serie de todos los datos que conforman el CFDI.	Sí
numeroSerieCsd	xs:string Número de serie del certificado de sello dígital.	Sí
version	xs:string Versión del CFDI.	Sí
fechaEmision	xs:dateTime Fecha de emisión del CFDI.	Sí
fechaPago	xs:date Fecha en la que se realizará el pago del CFDI.	Sí
importeDescuentos	xs:decimal Monto total de descuento sobre los bienes amparados bajo el CFDI.	Sí
importeTotal	xs:decimal Monto total que expresa el balance entre el subtotal y los demás importes del CFDI.	Sí
subtotal	xs:decimal Cantidad que expresa el subtotal de la suma de los bienes amparados bajo el CFDI.	Sí
monedaTipoCambio	xs:decimal Tipo de cambio en el que se expresa la moneda usada en el CFDI.	Sí
cancelada	xs:boolean Bandera que indica si el CFDI está cancelado.	Sí
emisor	Tipo complejo emisor Contiene la información del emisor de este comprobante. Más información	Si
Atributos del tipo complejo emisor Nombre Descripción Requerido nombre xs:string Razón social de quién emite el CFDI. Sí rfc xs:string RFC del emisor. Sí direccionFiscal Tipo complejo direccionFiscal Contiene la dirección fiscal detallada del emisor de este comprobante. Más información Si Atributos del tipo complejo direccionFiscal Nombre Descripción Requerido numeroExterior xs:string Número exterior del domicilio fiscal del emisor. Sí numeroInterior xs:string Número interior del domicilio fiscal del emisor. No pais xs:string País dónde se encuentra el domicilio fiscal del emisor. Sí referencia xs:string Rasgo geográfico útil para ubicar el domicilio fiscal del emisor. No estado xs:string Estado dónde se encuentra el domicilio fiscal del emisor. Sí colonia xs:string Colonia del domicilio fiscal del emisor. Sí codigoPostal xs:string Código postal del domicilio fiscal del emisor. Sí ciudad xs:string Ciudad donde se encuentra el domicilio fiscal del emisor. Sí calle xs:string Calle del domicilio fiscal del emisor. Sí direccionExpedicion Tipo complejo direccionExpedicion Contiene la dirección de expedición detallada del emisor de este comprobante. Más información Si Atributos del tipo complejo direccionExpedicion Nombre Descripción Requerido numeroExterior xs:string Número exterior del domicilio de expedición del emisor. Sí numeroInterior xs:string Número interior del domicilio de expedición del emisor. No pais xs:string País dónde se encuentra el domicilio de expedición del emisor. Sí referencia xs:string Rasgo geográfico útil para ubicar el domicilio de expedición del emisor. No estado xs:string Estado dónde se encuentra el domicilio de expedición del emisor. Sí colonia xs:string Colonia del domicilio de expedición del emisor. Sí codigoPostal xs:string Código postal del domicilio de expedición del emisor. Sí ciudad xs:string Ciudad donde se encuentra el domicilio de expedición del emisor. Sí calle xs:string Calle del domicilio de expedición del emisor. Sí
receptor	Tipo complejo receptor Contiene la información del receptor de este comprobante. Más información	Si
Atributos del tipo complejo receptor Nombre Descripción Requerido rfc xs:string RFC del receptor. Sí nombre xs:string Razón social del receptor de la factura Sí calle xs:string Calle del domicilio fiscal del receptor. No numeroExterior xs:string Número exterior del domicilio fiscal del receptor. No numeroInterior xs:string Número interior del domicilio fiscal del receptor. No referencia xs:string Rasgo geográfico útil para ubicar el domicilio fiscal del receptor. No colonia xs:string Colonia del domicilio fiscal del receptor. No codigoPostal xs:string Código postal del domicilio fiscal del receptor. No ciudad xs:string Ciudad donde se encuentra el domicilio fiscal del receptor. No municipio xs:string Municipio dónde se encuentra el domicilio fiscal del receptor. No estado xs:string Estado dónde se encuentra el domicilio fiscal del receptor. No pais xs:string País dónde se encuentra el domicilio fiscal del receptor. No usoCFDI xs:string Código del uso de CFDI de acuerdo a los catálogos del SAT. Sí email xs:string Correo electrónico del receptor. Sí
timbradoInfo	Tipo complejo timbradoInfo Contiene la información del timbre digital de este comprobante. Más información	Si
Atributos del tipo complejo timbradoInfo Nombre Descripción Requerido tfdCadenaOriginal xs:string Cadena que contiene todos los elementos que conforman el timbre fiscal digital. Sí tfdCertificadoSat xs:string Número de serie del certificado de sello digital asignado por el provedor autorizado de certificación. Sí tfdSelloDigital xs:string Garantía de la vinculación entre la identidad de un sujeto o entidad y su clave pública. Sí tfdUuid xs:string Identificador del timbre fiscal digital. Sí tfdVersion xs:string Versión del timbre fiscal digital. Sí tfdFechaTimbrado xs:string Fecha de timbrado de este comprobante. Sí cfdQrCode xs:string Código QR de este comprobante. Sí
concepto	Tipo complejo concepto Contiene la información de un concepto de este comprobante. Más información	Si
Atributos del tipo complejo concepto Nombre Descripción Requerido claveProdServ xs:string Clave del producto o del servicio amparado por el presente concepto de acuerdo al catálogo de productos y servicios publicado por el SAT. Sí noIdentificacion xs:string Código con el que se identifica comercialmente el bien. No claveUnidad xs:string Clave de unidad de medida estandarizada aplicable para la cantidad expresada en el concepto de acuerdo al catálogo publicado por el SAT. La unidad debe corresponder con la descripción del concepto. Sí unidad xs:string Unidad de medida en la que se expresa el bien. Sí descripcion xs:string Descripción del bien amparado bajo el CFDI. Sí cantidad xs:decimal Cantidad de bienes expresados bajo el mismo concepto. Sí valorUnitario xs:decimal Valor unitario del bien. Sí importe xs:decimal Importe de la parte del concepto. Sí importeDescuento xs:decimal Monto de descuento del bien. Sí
cfdiRelacionado	xs:string Cadena del CFDI relacionado con este CFDI.	No
xml	xs:base64Binary Arreglo de bytes que conforman el CFDI.	Sí

Ejemplo de respuesta

Descargar este ejemplo