Академический Документы
Профессиональный Документы
Культура Документы
Gua de Implementacin
Septiembre de 2011
Contenido
I.- Objetivo .................................................................................................................................................. 3 II.- Propsito................................................................................................................................................ 3 III.- Alcance .................................................................................................................................................. 3 IV.- Fuera de alcance................................................................................................................................... 4 V.- Definiciones, acrnimos y abreviaciones .............................................................................................. 4 VI.- Servicio Web del canal de Factura Electrnica de HEB ........................................................................ 5 1. Operaciones disponibles ..................................................................................................................... 5 2. URL del servicio web ........................................................................................................................... 5 VII.- Seguridad del servicio web .................................................................................................................. 6 VIII.- Validaciones Aplicables a CFD y CFDI ................................................................................................. 6 IX.- Estructura de Mensajes ........................................................................................................................ 8 1. Operacin getIntegrationNumber ................................................................................................... 8 2. Operacin getPurchaseOrder .......................................................................................................... 8 3. Operacin getSheetDifferences ...................................................................................................... 8 4. Operacin getReceiptNumber ......................................................................................................... 9 5. Operacin getMessage .................................................................................................................... 9 6. Operacin setDigitalInvoice............................................................................................................. 9 X.- Invocacin de Servicio Web del Canal HEB para Factura Electrnica ................................................. 10 XI.- Anexos ................................................................................................................................................ 11 1. Descripcin de Errores ...................................................................................................................... 11 XII.- Historial de cambios. ......................................................................................................................... 12
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
I.-
Objetivo
Describir las especificaciones y estndares para la implementacin de los servicios web (WS) que permitan el intercambio de documentos electrnicos, tales como facturas electrnicas en sus formatos CDF y CDFI; rdenes de compra; folios de integracin y de recepcin; as como la hoja de diferencias. Proveer a los proveedores de HEB de un mecanismo mediante el cual se facilite la consulta de las rdenes de compra asignadas a este, as como el envo de las facturas generadas durante un determinado perodo. Los servicios proveern de independencia a HEB en las comunicaciones con sus proveedores. As mismo, el modelo arquitectnico, aportar funcionalidad, escalabilidad y seguridad. Las caractersticas de los servicios son las siguientes: Servicios web reutilizables, los cuales estarn expuestos para el uso de los proveedores de HEB para la recepcin y consulta de documentos como rdenes de compra, folio de recepcin, Hoja de diferencia y la integracin de folios, as como facturas electrnicas y el acuse de recibo de estas. De acuerdo a necesidades futuras, algunos de los servicios web podran servir de base para la generacin de nuevos servicios web que podran ser expuestos a usuarios externos de HEB. El intercambio de informacin deber hacerse usando mecanismos que garanticen la seguridad e integridad de los datos intercambiados. Estandarizacin en el modelo de comunicacin de HEB con sus proveedores y viceversa.
II.-
Propsito
El propsito fundamental del documento es el describir el uso correcto de cada uno de las operaciones descritas en el WSDL de los servicios web expuestos por Supermercados Internacionales HEB para el intercambio de documentos con sus Proveedores o Acreedores.
III.-
Alcance
El documento contempla entre sus alcances: Descripcin de uso de los servicios web. Descripcin de las estructuras de mensajes de entrada y salida para cada una de las operaciones que componen a los servicios web expuesto por Supermercados Internacionales HEB. Recomendaciones generales para el uso de los servicios web. Descripcin del uso del complemento detallista, esquema definido por el SAT, como medio para el envo de la informacin complementaria requerida por Supermercados Internacionales HEB.
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
IV.-
Fuera de alcance
El documento no contempla entre sus alcances: Descripcin de los esquemas con las estructuras del Comprobante Fiscal Digital ni del Comprobante Fiscal Digital por Internet, mayor ello deber acceder la pagina de Servicio de Administracin Tributaria (SAT) mediante link http://www.sat.gob.mx. Polticas, reglas y acuerdos operativos o comerciales entre Supermercados Internacionales HEB y sus Proveedores o Acreedores. Modelo de cliente en lenguaje de programacin especfico, para el uso de los servicios web.
V.-
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
iii. Si el cdigo de barras es vlido y vigente, Se validar los artculos ordenados en OC contra los de la Factura. 1. Si el cdigo de barras no es vlido o vigente, se rechazara y se notificar el error. iv. Si los artculos ordenados en OC son mayores o iguales a los artculos facturados, notificar validez. 1. Si los artculos ordenados en OC son menor a las unidades facturadas, se rechazara e informara el error. b) Si en el complemento se cuenta con informacin de los folio de recepcin se validaran lo siguiente: i. Se validar las unidades recibidas contra las de las Facturadas. ii. Si las unidades recibidas son mayor o iguales a las unidades facturadas, se validar los cdigos de barras. 1. Si las unidades ordenadas en la OC son menores a las unidades facturadas, se rechazar e informara el error. iii. Si el cdigo de barras es vlido y vigente, se validar los artculos recibidos contra los Facturados. iv. Si los artculos recibidos son mayores o iguales a los artculos facturados, se validar si el documento es original o copia. 1. Si artculos recibidos son menor a los artculos facturados, se rechazar y se informar el error. v. Si el documento es original, se enviara el valor del campo de la factura. vi. Si el documento es una copia, se enviara el valor del campo de la orden de compra. c) Si en el complemento trae ambos documentos aplicar reglas del paso 5.b. i. Si no trae ningn documento asociado, se rechazara y se informara el error. d) Si no pasa las reglas de negocio, se rechazara y se informara el error.
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
2. Operacin getPurchaseOrder
3. Operacin getSheetDifferences
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
4. Operacin getReceiptNumber
5. Operacin getMessage
6. Operacin setDigitalInvoice
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
X.- Invocacin de Servicio Web del Canal HEB para Factura Electrnica
Para la invocacin y resultados, es importante resaltar que al ser un Servicio Web, toda invocacin se realiza mediante un mensaje SOAP, los documentos XML que aqu se describen debern contenerse dentro del segmento <Body> de dicho mensaje. A continuacin se describe (en trminos generales) la invocacin del Servicio Web. Debido a que ste es un servicio que cumple con las especificaciones de w3c (http://www.w3.org/standards/webofservices/) la invocacin puede variar dependiendo de la plataforma desde la cual se desarrolle el cliente (i.e..NET, Java, php, etc.), por ejemplo, en los siguientes URLs se podr consultar la forma en que se puede invocar un Web Service desde diferentes plataformas: Invocando un Web Service desde Java. http://www.ibm.com/developerworks/webservices/library/ws-javaclient/index.html Invocando un Web Service desde PHP. http://php.net/manual/en/book.soap.php
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
10
XI.- Anexos
1. Descripcin de Errores
En esta seccin podr encontrar un listado de los errores que puede obtener al enviar un CFD y CFDI a los Web Services de HEB, as como algunos comentarios en cada uno de los errores.
Cdigo INF0001 INF0002 INF0003 ERR0001 ERR0100 ERR0103 ERR0104 ERR0105 ERR0200 ERR0201 ERR0202 ERR0204 ERR0205 ERR0206 ERR0207 ERR0208 ERR0209 ERR9001 ERR9002 INF0004 ERR0300 ERR0301 INF0005 INF0006 INF0000 INF0007 ERR0400 PROVEEDOR NO AFILIADO A FE PROVEEDOR INACTIVO NO TIENE DOCUMENTOS PENDIENTES RFC DEL RECEPTOR NO VALIDO RFC DEL EMISOR NO VALIDO PAC NO VALIDO CERTIFICADO DE FACTURA NO VALIDO FOLIO DE FACTURA NO VALIDO NO TIENE DOCUMENTOS RELACIONADOS NO SE PUEDE FACTURAR MAS UNIDADES QUE LO ORDENADO EL CODIGO DE BARRAS NO EXISTE NO SE PUEDE FACTURAR MAS ARTICULOS QUE LO ORDENADO NO SE PUEDE FACTURAR MAS UNIDADES QUE LO RECIBIDO NO SE PUEDE FACTURAR MAS ARTICULOS QUE LO RECIBIDO CODIGO DE BARRAS ES INVALIDO FOLIO DE ORDEN DE COMPRA NO EXISTE FOLIO DE RECIBO NO EXISTE RANGO DE FECHAS INVALIDO - FECHA FINAL NO PUEDE SER MENOR QUE FECHA INICIAL RANGO DE FECHAS INVALIDO BURO NO ESTA AFILIADO A FACTURA ELECTRONICA PROVEEDOR NO ESTA AFILIADO AL BURO REGISTRO DE BURO INACTIVO DOCUMENTO VALIDO FISCALMENTE DOCUMENTO NO VALIDO FISCALMENTE DOCUMENTO VALIDO DOCUMENTO CFO VALIDO MENSAJE CONTIENE DISTINTOS RFCs Descripcin error
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
11
Autor Csar Fernndez Delgado Jess M. Arroyo Tobas. Jorge Leon Antonio Hernndez Gonzlez
Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene informacin de uso interno, considrese como herramienta de trabajo.
12