Вы находитесь на странице: 1из 12

Recepcin Factura Electrnica

Gua de Implementacin

Septiembre de 2011

HEB Recepcin Factura Electrnica Gua de Implementacin

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.

HEB Recepcin Factura Electrnica Gua de Implementacin

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.

HEB Recepcin Factura Electrnica Gua de Implementacin

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.-

Definiciones, acrnimos y abreviaciones


Acrnimo o Trmino CFD CFDI WS Descripcin Comprobante Fiscal Digital Comprobante Fiscal Digital por Internet Web Service

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.

HEB Recepcin Factura Electrnica Gua de Implementacin

VI.- Servicio Web del canal de Factura Electrnica de HEB


1. Operaciones disponibles
Operacin Integracin de Folio Hoja de Diferencias Recepcin de Factura rdenes de Compra Folios de Recibo Mensaje Servici getIntegrationNumber getSheetDifferences setDigitalInvoice getPurchaseOrder getReceipNumbre getMessage Descripcin Servicio que devuelve la informacin conciliada de los Folios Servicio que devuelve las diferencias en las entregas. Servicio que recibe la factura electrnica Servicio que devuelve las rdenes de compra. Servicio que devuelve los folios de recibo. Servicio de prueba para probar comunicacin.

Estas operaciones estn disponibles en los servicios web expuestos


versiones cdfv2-cfdv3 versiones cfdv2.2-cfdv3.2.

A continuacin se anexan las definiciones de los WSDL:

2. URL del servicio web


A continuacin se anexan las URL de los servicios web de afiliacin.

https://recepcionfe.heb.com.mx:9087/MexicoDigitalInvoiceService?wsdl (cfdv2 y cfdv3) https://recepcionfe.heb.com.mx:9091/MexicoDigitalInvoiceService?wsdl (cfdv2.2 y cfdv3.2)

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.

HEB Recepcin Factura Electrnica Gua de Implementacin

VII.- Seguridad de los servicios web


Referente al tema de la seguridad se validara la autenticacin y la encriptacin del canal de comunicacin con al WS. Para la autenticacin se utilizo Security Token del tipo UserNameToken. Para la encriptacin se utilizaran certificados de seguridad mismos que proporcionara HEB.

VIII.- Validaciones Aplicables a CFD y CFDI


Para que las CFD y CFDI puedan ser aceptadas por HEB, se deben cumplir con varios requisitos, tanto administrativos y fiscales. En esta seccin se describirn las validaciones generales aplicadas a dichos documentos para determinar si sern aceptados o rechazados. 1. El CFD y CFDI debe de apegarse a los lineamientos requeridos por la SAT. 2. El CFD y CFDI debe de contener un complemento conocido para HEB. 3. Validaciones fiscales para CFD a) Razn social y RFC del emisor. b) Razn social y RFC del receptor. c) Folio de la factura. d) Certificado, nmero y fecha de aprobacin del emisor. e) Sello digital del emisor 4. Validaciones fiscales para CFDI f) Razn social y RFC del emisor g) Razn social y RFC del receptor h) Folio de la factura i) Certificado, numero y fecha de aprobacin del emisor j) Sello digital del emisor k) Sello digital del validador (tercero autorizado) 5. Reglas administrativas sobre el complemento. a) Si en el complemento se cuenta con informacin de la Orden de Compara se validaran lo siguiente: i. Se validar las unidades ordenadas en OC contra las de la Factura. ii. Si las unidades ordenadas en OC son mayor o iguales a las unidades facturadas, se validar el cdigo de barras. 1. Si las unidades ordenadas en OC son menor a las unidades facturadas, se rechazar e 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.

HEB Recepcin Factura Electrnica Gua de Implementacin

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.

HEB Recepcin Factura Electrnica Gua de Implementacin

IX.- Estructura de Mensajes


A continuacin se anexa la estructura conceptual de cada una de las operaciones con que el servicio cuenta. 1. Operacin getIntegrationNumber

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.

HEB Recepcin Factura Electrnica Gua de Implementacin

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.

HEB Recepcin Factura Electrnica Gua de Implementacin

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

HEB Recepcin Factura Electrnica Gua de Implementacin

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

HEB Recepcin Factura Electrnica Gua de Implementacin

XII.- Historial de cambios.


La presente tabla muestra el historial de los cambios que ha tenido el presente documento a raz de su creacin.

Versin 1.0 1.1 2.0

Fecha 04/05/2011 06/05/2011 19/06/2012

Descripcin Creacin Modificar


Se agregan comentarios para el uso del nuevo web service que se utiliza en las nuevas versiones cfdv2.2 y cfdv3.2

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

Вам также может понравиться