Especificación de Requerimientos. WEB SERVICE DE EMISIÓN Versión 1.5 Mayo 2012.

Transcripción

1 WEB SERVICE DE EMISIÓN Versión 1.5 Mayo 2012.

2 Tabla de contenido 6.1 MÉTODO DOPROCESS OBJCFD COMPLEMENTOS ADDENDA BATCHRESPONSE CATÁLOGO DE EXCEPCIONES ACCIONES A REALIZAR EN CASO DE EXCEPCIÓN CASOS DE USO Confidencial Buzón E, S.A de C.V. 2

3 1 Introducción El presente documento contiene la especificación para el Servicio de Emisión de Comprobantes Fiscales Digitales por Internet (CFDI) a través del Web Service (WS) de Buzón E de acuerdo a la regulación vigente por el Servicio de Administración Tributaria (SAT) en materia de CFDI. Los cambios en el documento marcados en color Amarillo, corresponden a los ajustes para la migración a versión CFDI Descripción general El Emisor deberá enviar una petición válida al WS de acuerdo a los parámetros de entrada para generación del CFDI. Buzón E validará los datos obtenidos, complementará la información necesaria para la generación del CFDI y lo regresará al usuario de acuerdo a los parámetros de salida. 3 Precondiciones Para poder utilizar este servicio es necesario lo siguiente: Contar con un contrato de servicios con Buzón E Solicitar las claves de acceso (Usuario, contraseña y Filetype) para la Emisión de CFDIs con Buzón E Cargar su certificado y llave en el módulo CEME Estar vigente y con permisos en la LCO del SAT 4 Alcance El servicio de Emisión de CFDIs a través de WS incluye la generación de los siguientes complementos: 1) Divisas. V 1.0 2) Donatarias V 1.1 3) Impuesto Local. V 1.0 4) Estado de Cuenta Bancario V 1.0 5) Estado de cuenta de combustibles de monederos electrónicos. V 1.0 6) Leyendas Fiscales. V 1.0 7) Persona Física integrante de Coordinado.V 1.0 8) Turista Pasajero Extranjero V 1.0 9) Instituciones Educativas Privadas. V ) Venta de Vehículos. V ) Terceros V 1.1 Confidencial Buzón E, S.A de C.V. 3

4 Buzón E realiza la generación del XML del CFDI cumpliendo con la estructura regulada por el SAT en el Anexo 20 vigente, la validez de la información es responsabilidad del Emisor. Buzón E realiza la generación del XML del CFDI con la información que se proporcione en la petición al WS por lo que no realiza ningún cálculo o verificación de importes. 5 Limitaciones La Emisión del CFDI no incluye la generación con complemento Detallista. La Emisión del CFDI no incluye el uso de Addendas Comerciales. Las peticiones (request incluyendo cabecera y cuerpo) no podrán ser mayores a 2 MB Por cuestiones de seguridad el WS tiene la política de atender como máximo 60 peticiones por segundo de la misma IP. 6 Método del WS El método que contiene el WS de acuerdo al WSDL (Webservice Definition Languange) es para la generación del CFDI es: doprocess(), el cual se describe a continuación. 6.1 Método doprocess El objetivo de este método es generar y regresar el XML del CFDI con base a la información enviada al momento de consumir el WS. Para acceder a este servicio se hace uso del siguiente Web Method: public BatchResponse DoProcess( IdUnico, Conector, comment, title, int filetype, int addendacode, anytype addendaxml, ObjCFD CFDObject, ) A continuación se describe cada uno de los parámetros de entrada/salida: Tabla de parámetros de entrada/salida para método doprocess() Variable Tipo Longitud Descripción? Entrada IdUnico String 50 Identificador único de documento SI Conector String 16 Conector de Receptor SI Comment String 30 Comentario No Title String 60 Titulo No FileType int NA Tipo de documento a procesar, SI (Número proporcionado por Buzón E el cual es único por Emisor.) AddendaCode int NA SI Debe ser igual a 0. AddendaXML String Objeto XML correspondiente a la definición No necesaria de cada cliente. CFDObject ObjCFD NA Objeto definido por BuzónE con datos fiscales requeridos para generar CFDI SI Confidencial Buzón E, S.A de C.V. 4

5 BatchResponse BatchResponse NA Salida Objeto que contiene la respuesta resultado de la petición. SI El username y password se enviaran en la cabecera SOAP por medio de la seguridad aplicada en Servicio Web usando el protocolo WS Security Ejemplo de manejo de parámetros dentro de la cabecera: <wsse:usernametoken wsu:id="securitytoken-f800e453-3a b a "> <wsse:username>16191</wsse:username> <wsse:password Type=" </wsse:usernametoken> 6.2 ObjCFD El objeto ObjCFD es un objeto definido por BuzónE, el cual contiene los campos definidos por el SAT para la generación de Comprobantes Fiscales Digitales publicados en el Diario Oficial de la Federación con fecha: 28 de diciembre de El objeto ObjCFD tiene la siguiente estructura: Ilustración 1. Diagrama de clases del objeto ObjCFD. El Objeto ObjCFD está compuesto de las siguientes clases: 1. Comprobante 2. Receptor 3. Emisor 4. Conceptos Confidencial Buzón E, S.A de C.V. 5

6 5. Impuestos 6. Calculo Divisas 7. Complemento Divisas 8. Complemento Donatarias 9. Complemento Impuestos Local 10. Complemento Estado de Cuenta Bancaria 11. Complemento Estado de cuenta de combustibles de monederos electrónicos. 12. Complemento Leyendas Fiscales. 13. Complemento Persona Física integrante de Coordinado. 14. Complemento Turista Pasajero Extranjero. 15. Complemento Instituciones Educativas Privadas. 16. Complemento Venta de Vehiculos. 17. Complemento Terceros. A continuación se describe la definición de cada una de las clases que forman este objeto Comprobante CFDObject Variable Tipo Descripción tipodecomprobante String Atributo para expresar el efecto del comprobante fiscal para el contribuyente emisor. Los valores Si permitidos son: ingreso, egreso y traslado Receptor ComprobanteReceptor Nodo para precisar la información del contribuyente receptor del Si comprobante. formadepago String Atributo para precisar la forma de pago que aplica para este comprobante fiscal Si digital. motivodescuento Atributo para expresar el motivo del descuento aplicable. No Emisor ComprobanteEmisor Nodo para expresar la información del contribuyente emisor del comprobante. Si condicionesdepago String Atributo para expresar las condiciones comerciales aplicables para el pago del No comprobante fiscal dígital. Certificado Atributo que sirve para expresar el certificado de sello digital que ampara al comprobante como texto, en formato No base 64. Conceptos ComprobanteConceptos Nodo para introducir la información detallada de un bien o servicio Si amparado en el comprobante. descuento Atributo para representar el importe total de los descuentos aplicables antes No de impuestos. subtotal Atributo para representar la suma de los importes antes de descuentos e Si impuestos. Total Atributo para representar la suma del subtotal, menos los descuentos Si Confidencial Buzón E, S.A de C.V. 6

7 Impuestos CalculoDivisas ComplementoComprobante ComprobanteImpuestos ComprobanteCalculoDivisas ComprobanteComplement os aplicables, más los impuestos trasladados, menos los impuestos retenidos. Nodo para capturar los impuestos aplicables. Contiene la información necesaria para la conversión de divisas Nodo para saber el tipo de Complementos Comprobante a generar (Edo de cuenta Combustible, Edo de cuenta Bancario,Donatarias, Divisas, Importe Local, Persona Física Integrante Coordinado, Turista Pasajero Extranjero, Leyendas Fiscales, Detallista); tomando en cuenta la sección Si No NO TipoCambio Define el tipo de cambio. NO** Moneda Define el tipo de moneda con base al iso NO** 4217 metododepago String Atributo requerido de texto libre para expresar el método de pago de los bienes o servicios amparados por el comprobante. Se entiende como método SI de pago leyendas tales como: cheque, tarjeta de crédito o debito, depósito en cuenta, etc. LugarExpedicion String Atributo requerido para incorporar el lugar de expedición del comprobante SI Atributo para incorporar al NumCtaPago String el pago menos los cuatro últimos dígitos del Condicional número de cuenta con la que se realizó * FolioFiscalOrig SerieFolioFiscalOrig FechaFolioFiscalOrig MontoFolioFiscalOrig Serie String datetime String Atributo opcional para señalar el número de folio fiscal del comprobante que se hubiese expedido por el valor total del comprobante, tratándose del pago en parcialidades Atributo opcional para señalar la serie del folio del comprobante que se hubiese expedido por el valor total del comprobante, tratándose del pago en parcialidades Atributo opcional para señalar la fecha de expedición del comprobante que se hubiese emitido por el valor total del comprobante, tratándose del pago en parcialidades. Se expresa en la forma aaaa-mm-ddthh:mm:ss, de acuerdo con la especificación ISO Atributo opcional para señalar el total del comprobante que se hubiese expedido por el valor total de la operación, tratándose del pago en parcialidades Atributo opcional para precisar la serie a la que corresponde el comprobante. Este Condicional * Condicional Condicional * Condicional * Confidencial Buzón E, S.A de C.V. 7

8 Folio String atributo acepta una cadena de caracteres alfabéticos de 1 a 10 caracteres sin incluir caracteres acentuados. 1 Atributo requerido que acepta un valor numérico entero superior a 0 que expresa el folio del comprobante. 2 * El campo es requerido únicamente cuando se cumple la condición de la descripción. **El campo es opcional, sin embargo, si no se utilizan estos campos, en el request los nodos deben venir vacíos Receptor ComprobanteReceptor Variable Tipo Descripción Rfc Atributo para precisar la Clave del Registro Federal de Contribuyentes Si correspondiente al contribuyente receptor del comprobante. Domicilio Ubicacion Nodo para especificar el domicilio fiscal del receptor Si Nombre Atributo opcional para precisar el nombre o razón social del contribuyente receptor. No Ubicacion Variable Tipo Descripción noexterior Atributo para expresar el número particular en donde se da la ubicación No sobre una calle dada. municipio Atributo para precisar el municipio o delegación (en el caso del Distrito No Federal) en donde se da la ubicación. pais Atributo requerido que sirve para precisar el país donde se da la ubicación. Si localidad Atributo para precisar la ciudad o población donde se da la ubicación. No calle Atributo para precisar la avenida, calle, camino o carretera donde se da la No ubicación. colonia Atributo para precisar la colonia en donde se da la ubicación cuando se desea No ser más específico en casos de ubicaciones urbanas. estado Atributo para precisar el estado o entidad federativa donde se da la No ubicación. codigopostal Atributo opcional que sirve para asentar el código postal en donde se da la ubicación. Si (sólo para el receptor) referencia Atributo para expresar una referencia de ubicación adicional. No nointerior Atributo para expresar información adicional para especificar la ubicación cuando calle y número exterior (noexterior) no resulten suficientes para determinar la ubicación de forma precisa. No Emisor ComprobanteEmisor Variable Tipo Descripción rfc String Atributo para la Clave del Registro Federal de Contribuyentes correspondiente al contribuyente emisor del comprobante sin Si 1 El emisor deberá solicitar la funcionalidad de Administrar el campo serie y folio desde la petición del WS a su ejecutivo de cuenta. 2 El emisor deberá solicitar la funcionalidad de Administrar el campo serie y folio desde la petición del WS a su ejecutivo de cuenta. Confidencial Buzón E, S.A de C.V. 8

9 guiones o espacios. DomicilioFiscal UbicacionFiscal Nodo para precisar la información de ubicación del domicilio fiscal del contribuyente emisor. ExpedidioEn Ubicacion Nodo para precisar la información de ubicación del domicilio en donde es emitido el comprobante fiscal en caso de que sea distinto del domicilio fiscal del contribuyente emisor. nombre String Atributo para el nombre o razón social del contribuyente emisor del comprobante. RegimenFiscal ArrayOf_tns1_Re gimenfiscal Nodo requerido para incorporar los regímenes en los que tributa el contribuyente emisor. Puede contener más de un régimen Si Si NO SI UbicacionFiscal Variable Tipo Descripción noexterior Atributo para expresar el número particular en donde se da la ubicación No sobre una calle dada. municipio Atributo para precisar el municipio o delegación (en el caso del Distrito Si Federal) en donde se da la ubicación. pais Atributo requerido que sirve para precisar el país donde se da la ubicación. Si localidad Atributo para precisar la ciudad o población donde se da la ubicación. No calle Atributo para precisar la avenida, calle, camino o carretera donde se da la Si ubicación. colonia Atributo para precisar la colonia en donde se da la ubicación cuando se desea No ser más específico en casos de ubicaciones urbanas. estado Atributo para precisar el estado o entidad federativa donde se da la Si ubicación. codigopostal Atributo opcional que sirve para asentar el código postal en donde se da la Si ubicación. referencia Atributo para expresar una referencia de ubicación adicional. No nointerior Atributo para expresar información adicional para especificar la ubicación cuando calle y número exterior (noexterior) no resulten suficientes para determinar la ubicación de forma precisa. No RegimenFiscal Variable Tipo Descripción Regimen Atributo requerido para incorporar el nombre del régimen en el que tributa el contribuyente emisor SI Conceptos ComprobanteConceptos Variable Tipo Descripción concepto ArrayOf:ComprobanteCo ncepto Nodo para introducir la información detallada de un bien o servicio amparado en el comprobante. Si ComprobanteConcepto Variable Tipo Descripción valorunitario String Atributo para precisar el valor o precio unitario Si del bien o servicio cubierto por el presente concepto. descripcion String Atributo para precisar la descripción del bien o servicio cubierto por el presente concepto. Si Confidencial Buzón E, S.A de C.V. 9

10 unidad String Atributo para precisar la unidad de medida aplicable para la cantidad expresada en el concepto. cantidad String Atributo para precisar la cantidad de bienes o servicios del tipo particular definido por el presente concepto. noidentificacion String Atributo para expresar el número de serie del bien o identificador del servicio amparado por el presente concepto. importe String Atributo 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. SI Si No Si Aduana cuentapredial Parte ArrayOf:ComprobanteI nformacionaduanera ArrayOf:ConceptoCuen tapredial ArrayOf:ConceptoParte Nodo para introducir la información aduanera aplicable cuando se trate de ventas de primera mano de mercancías importadas. Nodo para asentar el número de cuenta predial con el que fue registrado el inmueble, en el sistema catastral de la entidad federativa de que trate, o bien para incorporar los datos de identificación del certificado de participación inmobiliaria no amortizable. Nodo para expresar las partes o componentes que integran la totalidad del concepto expresado en el comprobante fiscal digital. terceros PorCuentaTerceros NO IEDU insteducativa NO vtavehiculos ventavehiculos NO NO (ver detalle**) NO (ver detalle**) NO (ver detalle**) ComprobanteInformacionAduanera Variable Tipo Descripción Numero String Atributo requerido para expresar el número del documento aduanero SI que ampara la importación del bien. Fecha Date Atributo requerido para expresar la fecha de expedición del documento SI aduanero que ampara la importación del bien. Se expresa en el formato aaaa-mm-dd aduana String Atributo opcional para precisar el nombre de la aduana por la que se efectuó la importación del bien. NO ConceptoCuentaPredial Variable Tipo Descripción numero String Atributo 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. SI ConceptoParte Variable Tipo Descripción cantidad String Atributo requerido para precisar la cantidad de bienes o SI servicios del tipo particular definido por la presente parte. unidad String Atributo opcional para precisar la unidad de medida aplicable NO para la cantidad expresada en la parte. noidentificacion String Atributo opcional para expresar el número de serie del bien o NO identificador del servicio amparado por la presente parte. descripcion String Atributo requerido para precisar la descripción del bien o SI servicio cubierto por la presente parte. valorunitario String Atributo opcional para precisar el valor o precio unitario del NO Confidencial Buzón E, S.A de C.V. 10

11 bien o servicio cubierto por la presente parte. Importe String Atributo opcional para precisar el importe total de los bienes o servicios de la presente parte. Debe ser equivalente al resultado de multiplicar la cantidad por el valor unitario expresado en la parte. NO InformacionAdua neta ArrayOf:Comprobant einformacionaduaner a Nodo para introducir la información aduanera aplicable cuando se trate de ventas de primera mano de mercancías importadas. NO (ver detalle **) Impuestos ComprobanteImpuestos Variable Tipo Descripción Retenciones ComprobanteImpuestosRetenciones Nodo para capturar los impuestos retenidos No aplicables TotalImpuestos Retenidos String Atributo para expresar el total de los impuestos retenidos que se desprenden de los conceptos expresados en el comprobante fiscal digital. No totalimpuestos Trasladados String Atributo para expresar el total de los impuestos trasladados que se desprenden de los conceptos expresados en el comprobante fiscal digital. Traslados ComprobanteImpuestosTraslados Nodo para asentar o referir los impuestos trasladados aplicables ComprobanteImpuestosRetenciones Variable Tipo Descripción retencion ArrayOF: ComprobanteImpuestosRetencion Nodo para la información detallada de una retención de impuesto específico SI ComprobanteImpuestosTraslados Variable Tipo Descripción traslado ArrayOF: ComprobanteImpuestosTraslado Nodo para asentar o referir los impuestos trasladados aplicables SI ComprobanteImpuestosRetencion Variable Tipo Descripción impuesto String Atributo requerido para señalar el tipo de impuesto retenido. Si importe String Atributo requerido para señalar el importe o monto del impuesto Retenido. Si No No ComprobanteImpuestosTraslado Variable Tipo Descripción impuesto String Atributo para señalar el tipo de impuesto trasladado. Si tasa decimal Atributo para señalar la tasa del impuesto que se traslada por cada Si concepto amparado en el comprobante. importe decimal Atributo para señalar el importe del impuesto trasladado. Si CalculoDivisas CalculoDivisas Confidencial Buzón E, S.A de C.V. 11

12 Variable Tipo Descripción tipodecambio String Define el tipo de cambio en la generación del CFDI SI 6.3 Complementos Complementos Concepto Complemento Instituciones Educativas Privadas (insteducativas). insteducativas Propiedad Tipo Descripción Estado versión Atributo requerido con valor prefijado a 1.0 que indica la versión del estándar bajo el que se encuentra expresado el complemento concepto al comprobante. nombrealumno Atributo requerido para indicar el nombre del Alumno CURP Atributo requerido para indicar el CURP del alumno de la institución educativa niveleducativo Atributo requerido para indicar el nivel educativo que cursa el alumno Atributo requerido para especificar la autorización o AutRVOE reconocimiento de validez oficial de estudios en los términos de (Autorización la Ley General de Educación que tenga la institución educativa Oficial) privada donde se realiza el pago rfcpago Atributo opcional para indicar el RFC de quien realiza el pago cuando sea diferente a quien recibe el servicio Complemento Venta de Vehículos (VentaVehiculos) VentaVehiculos Propiedad Tipo Descripción Estado Version Atributo requerido con valor prefijado a 1.0 que indica la versión del estándar bajo el que se encuentra expresado el comprobante. ClaveVehicular String Atributo requerido para precisar Clave vehicular que corresponda a la versión del vehículo enajenado. nfoaduanera ArrayOf:Co mprobantei nformacion Aduanera parte ArrayOf:Con ceptoparte Valor Unitario Importe Numero (pedimento) t_importe t_importe Atributo opcional para precisar el valor o precio unitario del bien o servicio cubierto por la presente parte. Atributo opcional para precisar el importe total de los bienes o servicios de la presente parte. Debe ser equivalente al resultado de multiplicar la cantidad por el valor unitario expresado en la parte. ventavehiculos:t_informacionaduanera Atributo requerido para expresar el número del documento aduanero que ampara la importación del bien. Confidencial Buzón E, S.A de C.V. 12

13 Fecha Aduana date Atributo requerido para expresar la fecha de expedición del documento aduanero que ampara la importación del bien. Atributo opcional para precisar la aduana por la que se efectuó la importación del bien. Complemento orden y cuenta de terceros (PorCuentadeTerceros) PorCuentaTerceros Propiedad Tipo Descripción Estado Versión RFC Nombre InformacionFiscal Tercero infoaduanera parte ctapredial Impuestos UbicacionFisc al ArrayOf:Com probanteinfo rmacionadua nera ArrayOf:Conc eptoparte ConceptoCue ntapredial Comprobante ImpuestosTer ceros Atributo requerido con valor prefijado a 1.1 que indica la versión del estándar bajo el que se encuentra expresado el complemento. Atributo requerido para la Clave del Registro Federal de Contribuyentes correspondiente al contribuyente emisor del comprobante sin guiones o espacios. Atributo opcional para el nombre o razón social del contribuyente emisor del comprobante. ComprobanteImpuestosTerceros Retenciones Traslados Comprobante ImpuestosRet enciones Comprobante ImpuestosTra slados Complementos Comprobante ComprobanteComplementos Propiedad Tipo Descripción Estado TPE TuristaPasajeroExtranjero PFIC PFintegranteCoordinado LeyendasFisc LeyendasFiscales Implocal ImpuestosLocales ECC EstadoDeCuentaCombustib le ECB EstadoDeCuentaBancario Donatarias11 Donatarias11 Divisas Divisas Confidencial Buzón E, S.A de C.V. 13

14 - Complemento Estado de Cuenta de Combustibles (EstadoDeCuentaCombustible) EstadoDeCuentaCombustible Propiedad Tipo Descripción Estado tipooperacion Atributo requerido para expresar el tipo de operación de acuerdo con el medio de pago. numerodecuenta Nodo requerido para expresar el número de cuenta del adquirente del monedero electrónico subtotal decimal Atributo opcional para representar la suma de todos los importes tipo ConceptoEstadoDeCuentaCombustible. Total decimal Atributo requerido para expresar el monto total de consumo decombustible. Conceptos ArrayOf:Con ceptosecc Traslados ArrayOf:Co mprobantei mpuestostr aslado ConceptosECC Identificador fecha datetime Atributo requerido para la expresión del identificador o número del monedero electrónico Atributo requerido para la expresión de la Fecha y hora de expedición de la operación reportada. Se expresa en la forma aaaa-mm-ddthh:mm:ss, de acuerdo con la especificación ISO rfc Atributo requerido del RFC del enajenante del combustible claveestacion cantidad nombrecombustible foliooperacion valorunitario importe decimal decimal decimal Atributo requerido para expresar la clave de cliente de la estación de servicio, a 10 caracteres, cuando sea requerido. Atributo requerido para definir el volumen de combustible adquirido. Atributo requerido para expresar el nombre del combustibleadquirido. Atributo requerido para referir el número de folio de cada operación realizada por cada monedero electrónico. Atributo requerido para definir el precio unitario del combustible adquirido. Atributo requerido para definir el monto total de consumo de combustible. Debe ser equivalente al resultado de multiplicar la cantidad por el valor unitario. Reuqerido ComprobanteImpuestosTraslado impuesto tasa decimal importe decimal Atributo requerido para definir el tipo de impuesto trasladado puede ser IVA u IEPS Atributo requerido para señalar la tasa del impuesto que se traslada por cada concepto amparado en el comprobante Atributo requerido para definir el importe o monto del impuesto trasladado - Complemento Estado de Cuenta Bancario Confidencial Buzón E, S.A de C.V. 14

15 Complemento EstadoDeCuentaCombustible Propiedad Tipo Descripción Estado Versión Atributo requerido con valor prefijado a 1.0 que indica la versión del estándar bajo el que se encuentra expresado el complemento al comprobante. numerocuenta integer Atributo requerido para indicar el número de cuenta del producto bancario. nombrecliente Atributo requerido para indicar el nombre del cuentahabiente de la institución bancaria. Periodo Atributo requerido para indicar periodo de los cargos o abonos al instrumento bancario. Sucursal Atributo opcional para indicar la sucursal a la cual pertenece el cuentahabiente. EstadoDeCuentaBan ArrayOf:Mo cario vimientoecb ArrayOf:Mo MovimientoECBFisc vimientoecb al Fiscal MovimientoECB Fecha Referencia Descripción Importe Moneda saldoinicial saldoalcorte datetime decimal decimal decimal Atributo requerido únicamente para la expresión de la fecha (mes/día) de la operación realizada por el cuentahabiente. Atributo opcional para indicar el número de referencia o autorización con el que identifica la operación realizada por el cuentahabiente. Atributo requerido para precisar la descripción del bien o servicio cubierto por el cargo a la cuenta bancaria. Atributo requerido para indicar el importe de la operación realizada por el cuentahabiente por medio del instrumento bancario. Atributo opcional para indicar en qué moneda se realizó la operación. Si no se especifica dato alguno, se entenderá que el importe está expresado en moneda nacional. Atributo opcional para indicar el saldo inicial del instrumento bancario del cuentahabiente. Atributo opcional para indicar el saldo al corte del instrumento bancario del cuentahabiente. MovimientoECBFiscal Fecha datetime Referencia Descripción RFCenajenante Importe decimal Moneda Atributo requerido únicamente para la expresión de la fecha (mes/día) de la operación realizada por el cuentahabiente. Atributo opcional paras indicar el número de referencia o autorización con el que se identifica la operación realizada por el cuentahabiente. Atributo requerido para precisar la descripción del bien o servicio cubierto por el cargo a la cuenta bancaria. Atributo requerido para indicar el RFC del enajenante, sin el cual no se puede acreditar la compra del bien o servicio por medio del estado de cuenta bancario. Atributo requerido para indicar el importe de la operación realizada por el cuentahabiente por medio del instrumento bancario. Atributo opcional para indicar en qué moneda se realizó la operación. Si no se especifica dato alguno, se entenderá que el importe está expresado en moneda nacional. Confidencial Buzón E, S.A de C.V. 15

16 saldoinicial saldoalcorte decimal decimal Atributo opcional para indicar el saldo inicial del instrumento bancario del cuentahabiente. Atributo opcional para indicar el saldo al corte del instrumento bancario del cuentahabiente. - Complemento Donatarias Donatarias11 Propiedad Tipo Descripción Estado Atributo requerido para expresar la versión del version complemento de donatarias. Valor prefijado a 1.1 noautorizacion Atributo requerido para expresar el número del oficio en que se haya informado a la organización civil o fideicomiso, la procedencia de la autorización para recibir donativos deducibles, o su renovación correspondiente otorgada por el Servicio de Administración Tributaria. fechaautorizacion date Atributo requerido para expresar la fecha del oficio en que se haya informado a la organización civil o fideicomiso, la procedencia de la autorización para recibir donativos deducibles, o su renovación correspondiente otorgada por el Servicio de Administración Tributaria. Atributo requerido para señalar de manera expresa que el leyenda comprobante que se expide se deriva de un donativo. - Complemento Divisas Divisas Propiedad Tipo Descripción Estado Atributo requerido para expresar la versión del version complemento de divisas. Valor prefijado a 1.0 Elemento para definir el tipo de operación realizada. venta tipooperacion o compra de divisas - Complemento Impuestos Locales ImpuestosLocales Propiedad Tipo Descripción Estado version Atributo requerido para expresar la versión del complemento (1.0) TotaldeRetenciones decimal Atributo requerido para expresar la suma total de Retenciones aplicables TotaldeTraslados decimal Atributo requerido para expresar la suma total de traslados aplicables RetencionesLocales ArrayOf:Im puestosloc alesretenci ones TrasladosLocales ArrayOf:Im puestosloc alestraslad os ImpuestosLocalesRetenciones : ImpLocalRetencion ImpLocRetenido Nombre del impuesto local retenido Confidencial Buzón E, S.A de C.V. 16

17 TasadeRetencion decimal Porcentaje de retención del impuesto local Importe decimal Monto del impuesto local retenido ImpuestosLocalesTraslados : ImpLocalTraslado ImpLocTrasladado String Nombre del impuesto local trasladado TasadeTraslado decimal Porcentaje de traslado del impuesto local Importe decimal Monto del impuesto local trasladado - Complemento Persona Física integrante de Coordinado PFintegranteCoordinado Propiedad Tipo Descripción Estado version Atributo requerido con valor prefijado a 1.0 que indica la versión del estándar bajo el que se encuentra expresado el complemento. ClaveVehicular Atributo requerido para precisar Clave vehicular que corresponda a la versión del vehículo enajenado. Placa Atributo requerido para señalar la placa o número de folio del permiso del vehículo que corresponda. RFCPF pfic:t_rfc Atributo requerido para señalar la placa o número de folio del permiso del vehículo que corresponda. - Complemento Turista Pasajero Extranjero TuristaPasajeroExtranjero Propiedad Tipo Descripción Estado version Versión del complemento para TuristaPasajeroExtranjero. fechadetransito tipotransito datostransitos datetime TPEdatosTra nsitos Atributo requerido para expresar la fecha y hora del Arribo o Salida del medio de transporte utilizado. Se expresa en la forma aaaammddthh:mm:ss, de acuerdo con la especificación ISO Atributo requerido para incorporar la operación realizada: Arribo o Salida. TPEdatosTransitos Via TipoId NumeroId Atributo requerido para expresar si es vía Aérea, Marítima o "Terrestre". Atributo requerido para expresar el tipo de identificación mostrada. Atributo requerido para expresar el número de identificación (Pasaporte, visa, etc.) Nacionalidad Atributo requerido para expresar la nacionalidad del turista. EmpresaTransporte IdTransporte Atributo requerido para señalar la empresa de transporte que lo ingresa a territorio nacional o lo traslada de salida. Atributo opcional para expresar el identificador del medio de transporte usado, ejemplo: número de vuelo. Confidencial Buzón E, S.A de C.V. 17

18 - Complemento Leyendas Físicas LeyendasFiscales Propiedad Tipo Descripción Estado version Atributo requerido para expresar la versión del complemento de Leyendas Fiscales. Leyenda ArrayOf:Ley endasfiscale s LeyendasFiscales : Leyendas Propiedad Tipo Descripción Estado disposicionfiscal Atributo opcional para especificar la Ley, Resolcuión o Disposición fiscal que regula la leyenda, deberá expresarse en siglas de mayúsculas y sin puntuación. norma Aributo opcional para especificar el número de Artículo o en su caso Regla que regula la obligación de la leyenda textoleyenda Atributo requerido para especificar la leyenda fiscal. *En el caso de los campos de información aduanera son opcionales pero en caso de que aplique los campos número y fecha deberán contener información 6.4 Addenda La adenda es opcional y en caso de incluirla debe estar construida en formato XML. Para su manejo, es necesario tener configurado el filetype y cargado el xsd de su addenda en el DataPower. El XML de Addenda debe de contener ciertos elementos obligatorios en su definición, los cuales son mencionados en la siguiente tabla. El resto de los campos contenidos en Addenda deberán ser definidos a conveniencia del Cliente. El prefijo que debe tener la Addenda es ext. Variable Tipo Descripción Estado Conector Conector del Receptor y vacio CadenaOriginal Cadena Original del CFD y vacío IdDoc No. Interno de Documento y vacío Nota: De acuerdo al anexo 20 del Diario Oficial de la Federación, si en el XML se requiere del uso de algún carácter especial (,,&,<,>), este deberá ser indicado mediante su correspondiente secuencia de escape. Ejemplo: el carácter & se sustituye por & A continuación se muestra un ejemplo de la declaración del Esquema de la Addenda. Confidencial Buzón E, S.A de C.V. 18

19 <?xml version="1.0" encoding="utf-8"?> <schema targetnamespace=" elementformdefault="qualified" attributeformdefault="unqualified" xmlns=" xmlns:xs=" xmlns:ext=" <element name="elementosextra"> <annotation> <documentation>addenda</documentation> </annotation> <complextype> <element name="conector" type="xs:" minoccurs="1" maxoccurs="1" /> <element name="cadenaoriginal" type="xs:" minoccurs="0" maxoccurs="1" /> <element name="iddoc" type="xs:" minoccurs="0" maxoccurs="1" /> <element name="importeconletra" type="xs:" minoccurs="1" maxoccurs="1" /> <element name="vendedor" type="" minoccurs="0" maxoccurs="1" /> <element name="pdv" type="" minoccurs="0" maxoccurs="1" /> <element name="nosesion" type="xs:" minoccurs="0" maxoccurs="1" /> <element name="fol_vta" type="xs:" minoccurs="0" maxoccurs="1" />p <element name="numero" type="xs:" minoccurs="0" maxoccurs="1" /> <element name="nombreexpedidoen" type="xs:" minoccurs="0" maxoccurs="1" /> <element name="exptelefono" type="" minoccurs="0" maxoccurs="1" /> <element name="importedescuento" type="xs:" minoccurs="0" maxoccurs="1" /> <element name="partidas" minoccurs="0" maxoccurs="1"> <annotation> <documentation>nodo opcional para enlistar las partidas</documentation> </annotation> <complextype> <element name="elementosextralineapartida" maxoccurs="unbounded" minoccurs="0"> <complextype> <attribute name="conceptodescripcion" type="xs:" use="optional" /> <attribute name="conceptocantidad" type="xs:" use="optional" /> <attribute name="conceptounidad" type="xs:" use="optional" /> <attribute name="conceptovalorunitario" type="xs:" use="optional" /> <attribute name="conceptoimporte" type="xs:" use="optional" /> <attribute name="numeropartida" type="xs:" use="optional" /> <attribute name="weight" type="xs:" use="optional" /> <attribute name="originacronim" type="xs:" use="optional" /> <attribute name="destinationacronym" type="xs:" use="optional" /> <attribute name="descuento" type="xs:" use="optional" /> <attribute name="destinationadrress" type="xs:" use="optional" /> <attribute name="codigorastreo" type="xs:" use="optional" /> <attribute name="numeroguia" type="xs:" use="optional" /> <attribute name="contenidoenvio" type="xs:" use="optional" /> <attribute name="cantidadinternacional" type="xs:" use="optional" /> <attribute name="leyendapedimento" type="xs:" use="optional" /> <attribute name="valorcomercial" type="xs:" use="optional" /> <attribute name="rangoguiaini" type="xs:" use="optional" /> <attribute name="rangoguiafin" type="xs:" use="optional" /> <attribute name="primaseguro" type="xs:" use="optional" /> <attribute name="certificadoseguro" type="xs:" use="optional" /> <attribute name="leyendaseguro" type="xs:" use="optional" /> <attribute name="leyendaprepagado" type="xs:" use="optional" /> <attribute name="siglaspaisdest" type="xs:" use="optional" /> <attribute name="telefonodestino" type="xs:" use="optional" /> <attribute name="zona" type="xs:" use="optional" /> <attribute name="tipodocumento" type="xs:" use="optional" /> </element> </element> </element> </schema> Confidencial Buzón E, S.A de C.V. 19

20 A continuación se muestra un ejemplo del XML de la addenda para el objeto XmlDocument. <Addenda> <ext:elementosextra> <ext:conector> </ext:conector> <ext:cadenaoriginal></ext:cadenaoriginal> <ext:iddoc></ext:iddoc> <ext: Identificador>10</ext:Identificador> <ext:importeconletra>mil pesos</ext:importeconletra> <ext:vendedor>arely Mejia Claro</ext:Vendedor> <ext:pdv>domingo Diez</ext:PDV> <ext:nosesion>1000</ext:nosesion> <ext:fol_vta>100000</ext:fol_vta> <ext:numero>12345</ext:numero> <ext:nombreexpedidoen>se expidio en algún lugar</ext:nombreexpedidoen> <ext:exptelefono> </ext:ExpTelefono> <ext:importedescuento>quinientos pesos</ext:importedescuento> <ext:partidas> <ext:elementosextralineapartida ConceptoDescripcion="TARRO 310CC RIGOLETTE" ConceptoCantidad="24" ConceptoUnidad="PCE" ConceptoValorUnitario="10.45" ConceptoImporte="240.80" NumeroPartida="100" Weight="10.52" OriginAcronim="LME C4" DestinationAcronym="1" Descuento="0.00" DestinationAdrress="Dirección Destino" CodigoRastreo="945874" NumeroGuia=" " ContenidoEnvio="10 pzas." CantidadInternacional="10.5 pzas." LeyendaPedimento="Leyenda Pedimento" ValorComercial="Ningún Valor" RangoGuiaIni=" " RangoGuiaFin=" " PrimaSeguro="345.00" CertificadoSeguro="5" LeyendaSeguro="Leyenda Seguro" LeyendaPrepagado="Leyenda Prepagado" SiglasPaisDest="Siglas Pais Dest" TelefonoDestino=" " Zona="Zona" TipoDocumento="Tipo Documento" /> </ext:partidas> </ext:elementosextra> </Addenda> 6.5 BatchResponse El objeto BatchResponse esta compuesto por: BatchResponse Propiedad Tipo Descripción Estado XML anytype XML del CFDI Generado, será válido cuando la propiedad Diferente de nulo 3 error tenga como contenido una cadena vacía. Status Int Estado del documento en Buzón E : 7 = Terminado 99 = Error 10 = Enviado Error String(1-512) Si la cadena viene vacía no hubo errores, de lo contrario la cadena vendrá de la siguiente manera: Error Code X.X - YYYY Donde X.X es el número de error y YYYY es la descripción del mismo. BatchId Int Identificador o número de lote. solo para generación de CFDI UserValidation Boolean True si la validación de usuario y password fue correcta IdUnico String Identificador único de documento 3 Este valor será opcional para emisores cuya configuración en la base de datos de Buzón E, así lo indique. Confidencial Buzón E, S.A de C.V. 20

21 En caso de requerir la recuperación el XML de un CFDI generado previamente, el servicio de consulta estará disponible para proporcionar el estatus y el XML del CFDI, mediante el idunico a través del Web Service de Buzón E. Para mayor referencia consultar el documento BE-SRS_WS Consulta CFDI_v Catálogo de excepciones A continuación se detalla la clasificación de las excepciones que contendrá el objeto BatchResponse en su propiedad Error: Login Tipo Código Descripción A.0.1 Usuario/Contraseña no valida Comprobante A.1.3 Campo subtotal es nulo o vacio A Campo subtotal es inválido A Campo subtotal debe tener un valor positivo A Campo subtotal no debe contener el símbolo +" A Campo subtotal no tiene un correcto numero de decimales A.1.4 Campo Total es nulo o vacio A Campo Total es inválido A Campo Total debe tener un valor positivo A Campo Total no debe contener el símbolo +" A Campo total no tiene un correcto numero de decimales A.1.5 Campo descuento es inválido A Campo descuento debe tener un valor positivo A Campo descuento no debe contener el símbolo +" A Campo descuento no tiene un correcto numero de decimales Campo motivo descuento es requerido en caso de mandar un A descuento A.1.6 IdUnico duplicado A IdUnico duplicado, pero no se encontró el CFDI A IdUnico duplicado y se encontró más de un documento CFDI A El IdUnico ya no tiene un folio asignado A.1.9 Campo Lugar de Expedición es nulo o vacio Emisor A Campo Emisor.rfc es inválido A.2.2 Campo Emisor.nombre es nulo o vacio A Campo Emisor.DomicilioFiscal.codigoPostal es inválido Confidencial Buzón E, S.A de C.V. 21

22 A A A Campo Emisor.DomicilioFiscal.codigoPostal debe tener un valor positivo Campo Emisor.DomicilioFiscal.codigoPostal no debe contener los símbolos "+/-" Campo Emisor.DomicilioFiscal.codigoPostal tiene longitud inválida Receptor Conceptos Impuestos A Campo Emisor.DomicilioFiscal.codigoPostal debe ser un entero A.2.9 Campo régimen fiscal es nulo o vacio El nombre del Emisor se valida que es requerido desde el WSDL A Campo Receptor.rfc es inválido A Campo concepto.cantidad es inválido A Campo concepto.cantidad debe tener un valor positivo A Campo concepto.cantidad no debe contener el símbolo "+" A Campo concepto.cantidad debe ser un flotante con dos decimales A Campo concepto.valorunitario es inválido A Campo concepto.valorunitario debe tener un valor positivo A Campo concepto.valorunitario no debe contener el símbolo + A Campo concepto.valorunitario no tiene un correcto numero de decimales A Campo concepto.importe es inválido A Campo concepto.importe debe tener un valor positivo A Campo concepto.importe no debe contener el símbolo +" Campo concepto.importe debe tener un correcto numero de A decimales A El campo numero de información aduanera tiene un valor invalido A El campo numero de información aduanera tiene una longitud mayor a 15 A.5.1 Campo CFDI.Impuestos.totalImpuestosRetenidos es inválido A Campo CFDI.Impuestos.totalImpuestosRetenidos debe tener un valor positivo A A Campo CFDI.Impuestos.totalImpuestosRetenidos no debe contener el símbolo + Campo CFDI.Impuestos.totalImpuestosRetenidos no tiene un correcto numero de decimales A Campo CFDI.Impuestos.totalImpuestosRetenidos es nulo o vacio A Campo CFDI.Impuestos.totalImpuestosRetenidos es no requerido A.5.2 Campo CFDI.Impuestos.totalImpuestosTrasladados es inválido Confidencial Buzón E, S.A de C.V. 22

23 A A A Campo CFDI.Impuestos.totalImpuestosTrasladados debe tener un valor positivo Campo CFDI.Impuestos. totalimpuestostrasladados no debe contener el símbolo + Campo CFDI.Impuestos.totalImpuestosTrasladados no tiene un correcto numero de decimales A Campo CFDI.Impuestos.totalImpuestosTrasladados es nulo o vacio A Campo CFDI.Impuestos.totalImpuestosTrasladados es no requerido A.5.3 Campo Traslado.importe es nulo o vacio A Campo Traslado.importe es inválido A Campo Traslado.importe debe tener un valor positivo A Campo Traslado.importe no debe contener el símbolo + A Campo Traslado.importe no tiene un correcto numero de decimales A.5.4 Campo Traslado.impuesto es nulo o vacio A Campo Traslado.impuesto es inválido A.5.5 Campo Traslado.tasa es nulo o vacio A Campo Traslado.tasa es inválido A Campo Traslado.tasa debe tener un valor positivo A Campo Traslado.tasa no debe contener el símbolo + A Campo Traslado.tasa no tiene un correcto numero de decimales A.5.6 Campo Retencion.importe es nulo o vacio A Campo Retencion.importe es inválido A Campo Retencion.importe debe tener un valor positivo A Campo Retencion.importe no debe contener el símbolo + A Campo Retencion.importe no tiene un correcto numero de decimales A.5.7 Campo Retencion.impuesto es nulo o vacio A Campo Retencion.impuesto es inválido Batch A.6.1 Ya existe un documento con este BatchId A.6.2 Ya existe un documento con el mismo IDUnico A.6.3 IdUnico duplicado, pero no se encontró el CFDI A.6.4 IdUnico duplicado y se encontró más de un documento CFDI BatchStatus 4 El batch estatus ha sido terminado, pero la notificación por A.7. no se ha enviado aún, por favor espere unos segundos para verificar 4 Confidencial Buzón E, S.A de C.V. 23

24 el nuevamente el estatus. A.7.2 Batch Estatus error A.7.3 Tiempo de espera expirado. BatchResponse A.8.1 BatchId no existe A.8.2 No se puede leer xml final del disco, contacte al administrador del web service. Addenda A.9.1 Addenda.ext:Conector no es requerido. A.9.2 Addenda.ext:CadenaOriginal no es requerido. A.9.3 Addenda.ext:IdDoc no es requerido. A.9.4 addendacode inválido (no se utiliza para esta Fase I) A.9.5 Información de addenda inválida vs XSD Datos Generales A.10.1 filetype es nulo o vacio A.10.2 El certificado ha vencido A.10.3 El certificado del PS ha vencido A.10.4 Información de comprobante invalida vs XSDSat A.10.5 Error en cadena de entrada. Carácter (pipe) encontrado. A.10.6 Error al ejecutar alguna operación y manejar la precisión de 6 decimales WS A.11.1 Error al acceder a Web Service (doauthentic) A Error al obtener información de usuario en BD A Error al acceder a Web Service (getinfofolio) A Error al obtener información de BD No existe información para addendacode (no se utiliza para esta A Fase I) A Error al acceder a Web Service (doinfosave) A Error al insertar información en BD A Error al guardar archivo CFDI en filesystem A Error al generar el lote (batchid) A Error al acceder a Web Service (getinfocfdi) A Error al obtener información de BD A No existe información de CFDI para idunico Confidencial Buzón E, S.A de C.V. 24

25 A Se encontró más de un documento CFDI con los parámetros recibidos A No existe un rango de folios disponible A Valor incorrecto en parametro de entrada FileType A No se encuentra FileType A Valor vacío en parametro de entrada IDUnico A Error genérico A No se pudo obtener el Documento XML del CFDI A No se encuentra ningún Lote asociado al IDUnico: A Error al invocar dofree DP A.12.1 Error al generar cadena original A Error al generar sello digital con la llave privada del PSGECFDI A Error al generar el sello digital con la llave privada del Emisor A Error desconocido 6.7 Validaciones a nivel de WSDL Comprobante Emisor Tipo Campo Descripción de Validación formadepago tipodecomprobante tipodecomprobante Método de Pago Fecha Folio Fiscal Origen No Cuenta Pago No Cuenta Pago Se valida que se mande el nodo, puede ir vacio y en ese caso manda este error : Campo formadepago es nulo o vacio Se hace requerido por wsdl y con una lista de valores permitidos Sólo acepta ingreso, egreso y traslado, es validado por wsdl, por lo que no puede mandar otro valor Se valida que es requerido y no acepta NULOS ni vacios, si no cumple la regla no entra al servicio. Se valida que el tipo es de tipo datetime a nivel de WSDL Se valida la longitud anivel de WSDL, no puede contener menos de 4 dígitos. Se valida que no sea nulo o vacío. Emisor.rfc Se valida como requerido el nodo, sin embargo se acepta vacío, en ese caso manda el siguiente error: Campo Emisor.rfc es nulo o vacio Emisor.DomicilioFiscal.calle Se valida el nodo como requerido y no vacio Emisor.DomicilioFiscal.munic ipio Se valida el nodo como requerido y no vacio Confidencial Buzón E, S.A de C.V. 25

26 Receptor Conceptos Emisor.DomicilioFiscal.estad Se valida el nodo como requerido y no vacio o Emisor.DomicilioFiscal.pais Se valida el nodo como requerido y no vacio EmisorDomicilioFiscal.codigo Postal Emisor.ExpedidoEn.pais Receptor.rfc Receptor.Domicilio.pais Concepto.cantidad Concepto.descripcion Concepto.valorUnitario Concepto.importe Concepto.unidadMedida Se valida el nodo como requerido y no vacio Se valida el nodo como requerido y no vacio Se valida como requerido el nodo, sin embargo se acepta vacío, en ese caso manda el siguiente error: Campo Receptor.rfc es nulo o vacio Se valida como requerido el nodo, sin embargo se acepta vacío, en ese caso manda el siguiente error: Campo Receptor.Domicilio.pais es nulo o vacio Se valida como requerido el nodo, sin embargo se acepta vacío, en ese caso manda el siguiente error: Campo concepto.cantidad es nulo o vacio Se valida que es requerido y no acepta nulo o vacio Se valida que es requerido y no acepta nulo o vacio Campo concepto.valorunitario es nulo o vacio Se valida como requerido el nodo, sin embargo se acepta vacío, en ese caso manda el siguiente error: Campo concepto.importe es nulo o vacio Se valida que es requerido y no acepta nulo o vacio Campo unidad de medica es nulo o vacio 6.8 Acciones a realizar en caso de excepción Realizar las siguientes acciones de acuerdo a la clasificación del catálogo de excepciones: 1. Para las clasificaciones A.0, A.1, A.2, A.3, A.4, A.5, A.6, A.9 Corregir el dato de entrada descrito en el mensaje de excepción y volver a consumir el servicio para generar el documento CFDI (método DoProcess). 2. Para A.7: A.7.2 La solicitud se procesó y quedó en status de error (no se generó el CFDI), contactar soporte técnico en caso de requerir mayor información al respecto. A.7.3 La solicitud aún está en proceso, sin embargo la aplicación (método DoProcess) no puede esperar más tiempo para enviar una respuesta, por lo tanto se debe esperar un momento (al menos 5 segundos) e invocar el método getcfdi para recibir el XML generado. Confidencial Buzón E, S.A de C.V. 26

27 3. Para A.8: A.8.1 El CFDI se generó de manera correcta, sin embargo se presentó una excepción al momento que generar el objeto Response, por lo que se debe invocar el método getcfdi para recibir el XML generado. A El CFDI se generó de manera correcta, sin embargo se presentó una excepción al momento de cargar el XML y asignarlo a la propiedad Xml del objeto Response, por lo que se debe invocar el método getcfdi para recibir el XML generado. 4. Para A.10: A.10.1 Ingresar un valor para el filetype A.10.2 verificar que se cuente con certificados válido y vigente, en caso de no ser así, subir uno por medio del CEME (SSP). A.10.3 BuzónE no cuenta con un certificado vigente, comunicarse con ellos para que suba un certificado. A Verificar que la información insertada como addendacode sea válida ante XSDSat y consumir nuevamente el servicio de generación de CFDI (método DoProcess). A.10.5 Eliminar el carácter (pipe) de los campos de entrada, ya que esté carácter es inválido ante el SAT para cualquier campo del CFDI. 5. Para A.11 A.11.1 A.11.6 Contactar a soporte técnico. A.11.7 Ir al CEME y dar un rango de folios.a.11.8 A corregir el valor mencionado en el código de error y enviar la petición nuevamente Confidencial Buzón E, S.A de C.V. 27