Versión 1.0 Elaborado por: Ing. Victor Manuel Fascinetto Bocanegra. Guía uso Web Service CFDI33

Transcripción

1 [Especificación de Web Service para la generación de tickets.] En este documento se describe el uso del Web Service para la generación de tickets, la guía de uso y recomendación del mismo.

2 Índice Métodos: DigifactWS Método: IntroduceDatosTicketV Tipo de datos complejos: DigifactWS Tipo complejo: TicketRequest Tipo complejo: TicketResponse Ejemplo...12 Ruta de Webservice: Demo Producción

3 Métodos: DigiFactWS MÉTODOS Nombre IntroduceDatosTicketV33 Recibe un TicketRequest Método: IntroduceDatosTicketV33 3 Datos de entrada Elemento Tipo Obligatorio TicketRequest xs:ticketrequest Si Objeto que contiene un Ticket. Datos de salida Elemento Tipo TicketResponse xs:ticketresponse Objeto que tiene la información sobre el Ticket Creado.

4 Tipo Complejo: TicketRequest Tipo de objeto que contiene la información principal del Ticket Elemento Tipo Obligatorio Usuario xs:string Si Correo del Cliente Emisor SICOFI Contraseña xs:string Si Contraseña de la cuenta del Cliente Emisor SICOFI 4 DatosTicket xs: DatosTicket Si Objeto que contiene los datos del ticket ConceptosTicket xs:conceptosticket Si Objeto que contiene la información de los conceptos del ticket.

5 Tipo Complejo: DatosTicket Tipo de objeto que contiene los datos del Ticket. Elemento Tipo Obligatorio Serie xs:string No Atributo opcional para precisar la serie para control interno del contribuyente. Este atributo acepta una cadena de caracteres. Folio xs:int64 No Atributo opcional para control interno del contribuyente que expresa el folio del comprobante. FechaTicket xs:datetime Si Atributo requerido para la expresión de la fecha expedición del comprobante. Se expresa en la forma AAAA-MM-DDThh:mm:ss. FormaDePago xs:string No Atributo condicional para expresar la clave de la forma de pago de los bienes o servicios amparados por el comprobante. Si no se conoce la forma de pago este atributo se debe omitir. CondicionesDePago xs:string No Atributo condicional para expresar las condiciones comerciales aplicables para el pago del comprobante. Este atributo puede ser condicionado mediante atributos o complementos. SubTotal xs:double Si Atributo requerido para representar la suma de los importes de los conceptos antes de descuentos e impuesto. No se permiten valores negativos. Descuento xs:double No Atributo condicional para representar el importe total de los descuentos aplicables antes de impuestos. No se permiten valores negativos. Se debe registrar cuando existan conceptos con descuento. Moneda xs:string Si Atributo requerido para identificar la clave de la moneda utilizada para expresar los montos, cuando se usa moneda nacional se registra MXN. Conforme con la especificación ISO TipoCambio Xs:Double No Atributo condicional para representar el tipo de cambio conforme con la moneda usada. Es requerido cuando la clave de moneda es distinta de MXN y de XXX. El valor debe reflejar el número de pesos mexicanos que equivalen a una unidad de la divisa señalada en el atributo moneda. Si el valor está fuera del porcentaje aplicable a la moneda tomado del catálogo c_moneda, el emisor debe obtener del PAC que vaya a timbrar el CFDI, de manera no automática, una clave de confirmación para ratificar que el 5

6 Elemento Tipo Obligatorio valor es correcto e integrar dicha clave en el atributo Confirmacion. Total Xs:Double Si Atributo requerido para representar la suma del subtotal, menos los descuentos aplicables, más las contribuciones recibidas (impuestos trasladados - federales o locales, derechos, productos, aprovechamientos, aportaciones de seguridad social, contribuciones de mejoras) menos los impuestos retenidos. Si el valor es superior al límite que establezca el SAT en la Resolución Miscelánea Fiscal vigente, el emisor debe obtener del PAC que vaya a timbrar el CFDI, de manera no automática, una clave de confirmación para ratificar que el valor es correcto e integrar dicha clave en el atributo Confirmacion. No se permiten valores negativos. TipodeComprobante Xs:String Si Atributo requerido para expresar la clave del efecto del comprobante fiscal para el contribuyente emisor. MetodoPago Xs:String No Atributo condicional para precisar la clave del método de pago que aplica para este comprobante fiscal digital por Internet, conforme al Artículo 29-A fracción VII incisos a y b del CFF. LugarDeExpedicion Xs:String Si Atributo requerido para incorporar el código postal del lugar de expedición del comprobante (domicilio de la matriz o de la sucursal). DatosAdicionales Xs:String No MensajePDF Xs:String No NumeroTicket Xs:String No Atributo para control interno del contribuyente que expresa el número de ticket, acepta una cadena de caracteres. 6 Tipo Complejo: ConceptosTicket Tipo de objeto que contiene los datos de los Conceptos. Elemento Tipo Obligatorio ClaveProdServ xs:string Si Atributo requerido para expresar la clave del producto o del servicio amparado por el presente concepto. Es requerido y deben utilizar las claves del catálogo de productos y servicios, cuando los conceptos que registren por sus actividades correspondan con dichos conceptos.

7 Elemento Tipo Obligatorio NoIdentificacion xs:string No Atributo opcional para expresar el número de parte, identificador del producto o del servicio, la clave de producto o servicio, SKU o equivalente, propia de la operación del emisor, amparado por el presente concepto. Cantidad xs:double Si Atributo requerido para precisar la cantidad de bienes o servicios del tipo particular definido por el presente concepto. ClaveUnidad xs:string Si Atributo requerido para precisar la clave de unidad de medida estandarizada aplicable para la cantidad expresada en el concepto. La unidad debe corresponder con la descripción del concepto. Unidad xs:string No Atributo opcional para precisar la unidad de medida propia de la operación del emisor, aplicable para la cantidad expresada en el concepto. La unidad debe corresponder con la descripción del concepto. Descripcion xs:string Si Atributo requerido para precisar la descripción del bien o servicio cubierto por el presente concepto. ValorUnitario Xs:Double Si Atributo requerido para precisar el valor o precio unitario del bien o servicio cubierto por el presente concepto. Importe Xs:Double Si Atributo requerido para precisar el importe total de los bienes o servicios del presente concepto. Debe ser equivalente al resultado de multiplicar la cantidad por el valor unitario expresado en el concepto. No se permiten valores negativos. Descuento Xs:Double No Atributo opcional para representar el importe de los descuentos aplicables al concepto. No se permiten valores negativos. Traslados Retenciones Xs:List<ImpuestoTras ladado> Xs:List<ImpuestoRetenido> InformacionAduana Xs:List<InformacionAduanera> Predial Xs:CuentaPredial 7

8 Tipo Complejo: ImpuestoTrasladado Tipo de objeto que contiene los datos de los Impuestos Trasladados Elemento Tipo Obligatorio Base xs:double Si Atributo requerido para señalar la base para el cálculo del impuesto, la determinación de la base se realiza de acuerdo con las disposiciones fiscales vigentes. No se permiten valores negativos. Impuesto xs:string Si Atributo requerido para señalar la clave del tipo de impuesto trasladado aplicable al concepto. TipoFactor xs:string Si Atributo requerido para señalar la clave del tipo de factor que se aplica a la base del impuesto. TasaOCuota xs:double No Atributo condicional para señalar el valor de la tasa o cuota del impuesto que se traslada para el presente concepto. Es requerido cuando el atributo TipoFactor tenga una clave que corresponda a Tasa o Cuota. Importe xs:double No Atributo condicional para señalar el importe del impuesto trasladado que aplica al concepto. No se permiten valores negativos. Es requerido cuando TipoFactor sea Tasa o Cuota. 8

9 Tipo Complejo: ImpuestoRetenido Tipo de objeto que contiene los datos de los Impuestos Retenidos. Elemento Tipo Obligatorio Base xs:double Si Atributo requerido para señalar la base para el cálculo del impuesto, la determinación de la base se realiza de acuerdo con las disposiciones fiscales vigentes. No se permiten valores negativos. Impuesto xs:string Si Atributo requerido para señalar la clave del tipo de impuesto trasladado aplicable al concepto. TipoFactor xs:string Si Atributo requerido para señalar la clave del tipo de factor que se aplica a la base del impuesto. TasaOCuota xs:double No Atributo condicional para señalar el valor de la tasa o cuota del impuesto que se traslada para el presente concepto. Es requerido cuando el atributo TipoFactor tenga una clave que corresponda a Tasa o Cuota. Importe xs:double No Atributo condicional para señalar el importe del impuesto trasladado que aplica al concepto. No se permiten valores negativos. Es requerido cuando TipoFactor sea Tasa o Cuota 9 Tipo Complejo: InformacionAduanera Tipo de objeto que contiene los datos de la Aduana. Elemento Tipo Obligatorio Numero Pedimento xs:string Si Atributo requerido para expresar el número del pedimento que ampara la importación del bien que se expresa en el siguiente formato: últimos 2 dígitos del año de validación seguidos por dos espacios, 2 dígitos de la aduana de despacho seguidos por dos espacios, 4 dígitos del número de la patente seguidos por dos espacios, 1 dígito que corresponde al último dígito del año en curso, salvo que se trate de un pedimento consolidado iniciado en el año inmediato anterior o del pedimento original de una rectificación, seguido de 6 dígitos de la numeración progresiva por aduana.

10 Tipo Complejo: CuentaPredial Tipo de objeto que contiene los datos de la cuenta predial. Elemento Tipo Obligatorio Numero xs:string Si Atributo requerido para precisar el número de la cuenta predial del inmueble cubierto por el presente concepto, o bien para incorporar los datos de identificación del certificado de participación inmobiliaria no amortizable, tratándose de arrendamiento

11 Tipo Complejo: TicketsResponse Tipo de objeto que contiene la información de la respuesta de un Ticket Generado. Content Model Elemento Tipo Obligatorio Ticket xs:string Si Atributo que describe el detalle del ticket creado de manera exitosa, de lo contrario vendrá vacío CodigoError xs:string Si Atributo que describe el código del error, según sea el caso. Este atributo vendrá vacío si la creación del ticket es exitosa ErrorTicket xs:string Si Atributo que contiene la descripción del error según sea el caso. TicketCorrecto xs:boolean Si Atributo en el cual contará con el valor true en caso de que la creación del ticket sea exitoso y false en caso contrario

12 Ejemplo C# WSD.DigiFact df = new WSD.DigiFact(); WSD.TicketRequest request = new WSD. TicketRequest (); request.datoscfdi.serie = "A"; request.datoscfdi.folio = 1; request.datoscfdi.fechaticket = DateTime.Now; request.datoscfdi.formadepago = "01"; request.datoscfdi.condicionesdepago = ""; request.datoscfdi.subtotal = ; request.datoscfdi.descuento = 0.00; request.datoscfdi.moneda = "MXN"; request.datoscfdi.tipocambio = 0.00; request.datoscfdi.total = ; request.datoscfdi.tipodecomprobante = "FA"; request.datoscfdi.metodopago = "PUE"; request.datoscfdi.lugardeexpedicion = "53100"; request.datoscfdi.mensajepdf = ""; //Se llenan los atributos del objeto Concepto Request.Conceptos = new ConceptosTicket(); List<ConceptoTicket> l_conceptosticket = new List<ConceptoTicket>(); WS1.ConceptoTicket ConceptoTicket = new WS1.ConceptoTicket(); ConceptoTicket.ClaveProdServ = " "; ConceptoTicket.NoIdentificacion = "001"; ConceptoTicket.Cantidad = ; ConceptoTicket.claveUnidad = "P01"; ConceptoTicket.Unidad = "PZA"; ConceptoTicket.Descripcion = "1000 Timbres"; ConceptoTicket.ValorUnitario = 1.00; ConceptoTicket.Importe = ; ConceptoTicket.Descuento = 0.00; L_ConceptosTicket.Add(ConceptoTicket); //Se llenan los atributos del objeto ImpuestoTrasladado que contiene el objeto Concepto List<ImpuestoTrasladado> l_trasladados = new List<ImpuestoTrasladado>(); ImpuestoTrasladado.Base = ; ImpuestoTrasladado.Importe = 16.00; ImpuestoTrasladado.TipoFactor = "Tasa"; ImpuestoTrasladado.TasaOCuota = ; ImpuestoTrasladado.Impuesto = "002"; l_trasladados.add(impuestotrasladado);

13 Concepto //Se llenan los atributos del objeto ImpuestoRetenido que contiene el objeto List<ImpuestoRetenido> l_retenciones = new List<ImpuestoRetenido>(); ImpuestoRetenido.Base = ; ImpuestoRetenido.Importe = 16.00; ImpuestoRetenido.TipoFactor = "Tasa"; ImpuestoRetenido.TasaOCuota = ; ImpuestoRetenido.Impuesto = "002"; l_retenciones.add(impuestoretenido); //Se llenan los atributos del objeto Aduana que contiene el objeto Concepto List<InformacionAduanera> l_informacionaduanera = new List<InformacionAduanera>(); InformacionAduanera.NumeroPedimento = "1"; l_informacionaduanera.add(informacionaduanera); //Despues de haber llenado el objeto Request, finalmente se manda la petición al Web Service. df.introducedatosticketv33 (request);