3-heb - guia de implementacion

Septiembre de 2011

Recepción Factura Electrónica Guía de Implementación

HEB – Recepción Factura Electrónica Guía de Implementación

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 información de uso interno, considérese como herramienta de trabajo.

2

Contenido

I.- Objetivo .................................................................................................................................................. 3

II.- Propósito ................................................................................................................................................ 3

III.- Alcance .................................................................................................................................................. 3

IV.- Fuera de alcance ................................................................................................................................... 4

V.- Definiciones, acrónimos y abreviaciones .............................................................................................. 4

VI.- Servicio Web del canal de Factura Electrónica 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. Operación getIntegrationNumber ................................................................................................... 8

2. Operación getPurchaseOrder .......................................................................................................... 8

3. Operación getSheetDifferences ...................................................................................................... 8

4. Operación getReceiptNumber ......................................................................................................... 9

5. Operación getMessage .................................................................................................................... 9

6. Operación setDigitalInvoice............................................................................................................. 9

X.- Invocación de Servicio Web del Canal HEB para Factura Electrónica ................................................. 10

XI.- Anexos ................................................................................................................................................ 11

1. Descripción de Errores ...................................................................................................................... 11

XII.- Historial de cambios. ......................................................................................................................... 12




3

I.- Objetivo

Describir las especificaciones y estándares para la implementación de los servicios web (WS) que permitan el intercambio de documentos electrónicos, tales como facturas electrónicas en sus formatos CDF y CDFI; órdenes de compra; folios de integración y de recepción; 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 envío de las facturas generadas durante un determinado período. Los servicios proveerán de independencia a HEB en las comunicaciones con sus proveedores. Así mismo, el modelo arquitectónico, aportará funcionalidad, escalabilidad y seguridad. Las características de los servicios son las siguientes:

Servicios web reutilizables, los cuales estarán expuestos para el uso de los proveedores de HEB para la recepción y consulta de documentos como órdenes de compra, folio de recepción, Hoja de diferencia y la integración de folios, así como facturas electrónicas y el acuse de recibo de estas.

De acuerdo a necesidades futuras, algunos de los servicios web podrían servir de base para la generación de nuevos servicios web que podrían ser expuestos a usuarios externos de HEB.

El intercambio de información deberá hacerse usando mecanismos que garanticen la seguridad e integridad de los datos intercambiados.

Estandarización en el modelo de comunicación de HEB con sus proveedores y viceversa.

II.- Propósito

El propósito 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:

Descripción de uso de los servicios web.

Descripción 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.

Descripción del uso del complemento detallista, esquema definido por el SAT, como medio para el envío de la información complementaria requerida por Supermercados Internacionales HEB.




4

IV.- Fuera de alcance

El documento no contempla entre sus alcances:

Descripción 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 Administración Tributaria (SAT) mediante link http://www.sat.gob.mx.

Políticas, reglas y acuerdos operativos o comerciales entre Supermercados Internacionales HEB y sus Proveedores o Acreedores.

Modelo de cliente en lenguaje de programación específico, para el uso de los servicios web.

V.- Definiciones, acrónimos y abreviaciones

Acrónimo o Término Descripción

CFD Comprobante Fiscal Digital

CFDI Comprobante Fiscal Digital por Internet

WS Web Service

http://www.sat.gob.mx/




5

VI.- Servicio Web del canal de Factura Electrónica de HEB

1. Operaciones disponibles

Operación Servició Descripción

Integración de Folio getIntegrationNumber Servicio que devuelve la información conciliada de los Folios

Hoja de Diferencias getSheetDifferences Servicio que devuelve las diferencias en las entregas.

Recepción de Factura setDigitalInvoice Servicio que recibe la factura electrónica

Órdenes de Compra getPurchaseOrder Servicio que devuelve las órdenes de compra.

Folios de Recibo getReceipNumbre Servicio que devuelve los folios de recibo.

Mensaje getMessage Servicio de prueba para probar comunicación.

Estas operaciones están disponibles en los servicios web expuestos

versiones cdfv2-cfdv3

versiones cfdv2.2-cfdv3.2.

A continuación se anexan las definiciones de los WSDL:

2. URL del servicio web A continuación se anexan las URL de los servicios web de afiliación. https://recepcionfe.heb.com.mx:9087/MexicoDigitalInvoiceService?wsdl (cfdv2 y cfdv3) https://recepcionfe.heb.com.mx:9091/MexicoDigitalInvoiceService?wsdl (cfdv2.2 y cfdv3.2)

https://recepcionfe.heb.com.mx:9087/MexicoDigitalInvoiceService?wsdl

https://recepcionfe.heb.com.mx:9091/MexicoDigitalInvoiceService?wsdl




6

VII.- Seguridad de los servicios web Referente al tema de la seguridad se validara la autenticación y la encriptación del canal de comunicación con al WS. Para la autenticación se utilizo Security Token del tipo UserNameToken. Para la encriptación 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 sección se describirán las validaciones generales aplicadas a dichos documentos para determinar si serán 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) Razón social y RFC del emisor. b) Razón social y RFC del receptor. c) Folio de la factura. d) Certificado, número y fecha de aprobación del emisor. e) Sello digital del emisor

4. Validaciones fiscales para CFDI f) Razón social y RFC del emisor g) Razón social y RFC del receptor h) Folio de la factura i) Certificado, numero y fecha de aprobación 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 información 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 código

de barras. 1. Si las unidades ordenadas en OC son menor a las unidades facturadas, se rechazar e informara el

error.




7

iii. Si el código de barras es válido y vigente, Se validar los artículos ordenados en OC contra los de la Factura.

1. Si el código de barras no es válido o vigente, se rechazara y se notificar el error. iv. Si los artículos ordenados en OC son mayores o iguales a los artículos facturados, notificar validez.

1. Si los artículos ordenados en OC son menor a las unidades facturadas, se rechazara e informara el error.

b) Si en el complemento se cuenta con información de los folio de recepción 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 códigos 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 código de barras es válido y vigente, se validar los artículos recibidos contra los Facturados. iv. Si los artículos recibidos son mayores o iguales a los artículos facturados, se validar si el documento

es original o copia. 1. Si artículos recibidos son menor a los artículos 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 ningún documento asociado, se rechazara y se informara el error.

d) Si no pasa las reglas de negocio, se rechazara y se informara el error.




8

IX.- Estructura de Mensajes A continuación se anexa la estructura conceptual de cada una de las operaciones con que el servicio cuenta.

1. Operación getIntegrationNumber

2. Operación getPurchaseOrder

3. Operación getSheetDifferences




9

4. Operación getReceiptNumber

5. Operación getMessage

6. Operación setDigitalInvoice




10

X.- Invocación de Servicio Web del Canal HEB para Factura Electrónica Para la invocación y resultados, es importante resaltar que al ser un Servicio Web, toda invocación se realiza mediante un mensaje SOAP, los documentos XML que aquí se describen deberán contenerse dentro del segmento <Body> de dicho mensaje. A continuación se describe (en términos generales) la invocación del Servicio Web. Debido a que éste es un servicio que cumple con las especificaciones de w3c (http://www.w3.org/standards/webofservices/) la invocación puede variar dependiendo de la plataforma desde la cual se desarrolle el cliente (i.e..NET, Java, php, etc.), por ejemplo, en los siguientes URL’s 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

http://www.ibm.com/developerworks/webservices/library/ws-javaclient/index.html

http://php.net/manual/en/book.soap.php




11

XI.- Anexos

1. Descripción de Errores En esta sección 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.

Código Descripción error

INF0001 PROVEEDOR NO AFILIADO A FE

INF0002 PROVEEDOR INACTIVO

INF0003 NO TIENE DOCUMENTOS PENDIENTES

ERR0001 RFC DEL RECEPTOR NO VALIDO

ERR0100 RFC DEL EMISOR NO VALIDO

ERR0103 PAC NO VALIDO

ERR0104 CERTIFICADO DE FACTURA NO VALIDO

ERR0105 FOLIO DE FACTURA NO VALIDO

ERR0200 NO TIENE DOCUMENTOS RELACIONADOS

ERR0201 NO SE PUEDE FACTURAR MAS UNIDADES QUE LO ORDENADO

ERR0202 EL CODIGO DE BARRAS NO EXISTE

ERR0204 NO SE PUEDE FACTURAR MAS ARTICULOS QUE LO ORDENADO

ERR0205 NO SE PUEDE FACTURAR MAS UNIDADES QUE LO RECIBIDO

ERR0206 NO SE PUEDE FACTURAR MAS ARTICULOS QUE LO RECIBIDO

ERR0207 CODIGO DE BARRAS ES INVALIDO

ERR0208 FOLIO DE ORDEN DE COMPRA NO EXISTE

ERR0209 FOLIO DE RECIBO NO EXISTE

ERR9001 RANGO DE FECHAS INVALIDO - FECHA FINAL NO PUEDE SER MENOR QUE FECHA INICIAL

ERR9002 RANGO DE FECHAS INVALIDO

INF0004 BURO NO ESTA AFILIADO A FACTURA ELECTRONICA

ERR0300 PROVEEDOR NO ESTA AFILIADO AL BURO

ERR0301 REGISTRO DE BURO INACTIVO

INF0005 DOCUMENTO VALIDO FISCALMENTE

INF0006 DOCUMENTO NO VALIDO FISCALMENTE

INF0000 DOCUMENTO VALIDO

INF0007 DOCUMENTO CFO VALIDO

ERR0400 MENSAJE CONTIENE DISTINTOS RFCs




12

XII.- Historial de cambios.

La presente tabla muestra el historial de los cambios que ha tenido el presente documento a raíz de su creación.

Versión Fecha Descripción Autor

1.0 04/05/2011 Creación César Fernández Delgado

1.1 06/05/2011 Modificar Jesús M. Arroyo Tobías.

2.0 19/06/2012 Se agregan comentarios para el uso del nuevo web service que se utiliza en las

nuevas versiones cfdv2.2 y cfdv3.2

Jorge Leon Antonio Hernández González

3-heb - guia de implementacion

Documents