/ API / RecepcionesSincronización de Recepciones (para compradores)

Ruta de acceso: http://www.bee2bee/syncro/receptions

Bee2Bee ofrece también la posibilidad de subir las recepciones y devoluciones de mercadería por parte de la empresa Compradora. La documentación que se podrá cargar contienen los datos necesarios para que los Proveedores pueden conocer, de los remitos enviados,

  • que mercadería fue recibida satisfactoriamente
  • que mercadería fue rechazada
  • los documentos entregados (facturas, remitos, notas de crédito, etc)
  • estimación de fecha de pago de factura(s).

Para sincronizar esta información la empresa Compradora deberá enviar el siguiente archivo XML, donde se envian un conjunto de recepciones:

<syncro> 
    <appkey>19efd346ddca</appkey> 
	<receptions type="array">
		<reception>
			<tipo>RE</tipo>
			<ref>1233</ref>
			<doc-date type="date">2008-10-15</doc-date>
			<from-supplier>6072</from-supplier>
			<deliver-to>LP</deliver-to>
			<payable>2008-11-13</payable>
			<orders type="array">
				...
			</orders>
			<docs type="array">
				...
			</docs>
		</reception>
			...
	</receptions>
</syncro>

donde asumimos cada <reception> corresponde a un remito de la empresa Proveedora. Los datos que se pueden consignar son en primera instancia los del encabezado del remito:

  • <tipo> de recepción. RE para una recepción o DE para una devolución.
  • <ref> de recepción: código (alfanumérico) de identificación única que tiene esta recepción. Bee2Bee utilizará este código, junto con el <tipo> para asegurarse que no hay duplicados.
  • <doc-date>: fecha de la recepción.
  • <from-supplier> es el código de Proveedor que la empresa Compradora conoce al Proveedor.
  • <deliver-to> es el código interno de la sucursal a la cual la mercadería ha llegado.
  • <payable> es la fecha estimada de pago que la empresa Compradora tiene sobre dicha recepción.
  • <payment-condition> (OPCIONAL) contiene información sobre la condición de pago.
  • <observations> (OPCIONAL) contiene información adicional (por ej. nro. de remito).

y a continuación el detalle de la recepción/devolución (<orders>) y los documentos asociados a la recepción/devolución (<docs>).

Detalle de recepción/remito

El detalle de la recepción/remito se consignan el código de cada producto individual entregado, su cantidad recibido y conformada. Se muestra a continuación un ejemplo:

<orders type="array">
  <order>
	<ref>2012870170</ref>
	<parent-ref>31870-170</parent-ref>
	<product-code>14002</product-code>
	<due-date type="date">2008-10-17</due-date>
	<quantity type="decimal">153.0</quantity>
	<unit>U</unit>
	<qreceived type="decimal">150.0</qreceived>
  </order>
  ...
</orders>

donde en cada linea del remito tenemos los siguientes tags disponibles:

  • <ref> corresponde a un código único que identifica este detalle de recepción. Es importante porque es el campo que se utiliza para validar si este detalle ya existe o no.
  • <product-code>: código de producto solicitado.
  • <qreceived>: cantidad aceptada por la empresa Compradora.
  • <unit>: unidad de las cantidades recibidas. Son 2 caracteres y seguiremos la nomenclatura de esta tabla.

Se pueden incluir los siguiente campos opcionales, que brindan información adicional de lo que fue enviado y permite un control más estricto del cumplimiento de las Notas de Pedido:

  • <parent-ref> (OPCIONAL) corresponde (preferentemente) a la referencia de Nota de Pedido solicitada. Esto es útil para luego dirimir diferencias entre lo recepcionado y lo solicitado en la Nota de Pedido.
  • <due-date> (OPCIONAL) corresponde a la fecha de recepción de esta mercadería
  • <description>: (OPCIONAL) descripcion del producto entregado
  • <quantity>: (OPCIONAL) cantidad solicitada en la Nota de Pedido original (en unidades correspondientes a <unit>).
  • <qrejected>: cantidad rechazada por la empresa Compradora (en unidades correspondientes a <unit>).

Documentos asociados

Habitualmente el remito viene junto con la factura y otros documentos. Bee2Bee permite opcionalmente asociar dichos documentos a la recepción en cuestión. Un ejemplo es:

<docs type="array">
  <doc>
	<tipo>FAC</tipo>
	<ref>200000</ref>
	<date type="date">2008-10-15</date>
	<amount type="decimal">123.52</amount>
	<currency>$ (AR)</currency>
  </doc>
  ...
</docs>

donde cada documento <doc> tiene los siguientes tags a consignar:

  • <tipo>: tipo de documento entregado. Se sugiere utilizar la siguiente nomeclatura para los distintos tipos de documentos: FAC para factura, ND para Nota de Débito, NC para Nota de Crédito.
  • <ref>: corresponde al código de indentificación del documento.
  • <date>: fecha del documento.
  • <amount>: importe del documento.
  • <currency>: moneda del importe del documento. Ver la siguiente tabla con los códigos sugeridos.

La idea de esta información adicional, es poder tener ordenadamente qué documentos ha recibido la empresa Compradora y asi poder continuar con la gestión de los documentos adicionales.

Tipo de sincronización

Para las recepciones se implementa un tipo de sincronización donde

  • se valida si existe la recepción por su correspondiente <ref>. Caso contrario se crea una nueva.
  • para cada <order> enviada asociada a la recepción, se verifica por los campos <ref> y <ref> si dicho detalle ya existe, caso contrario se crea una nueva.
  • igualmente para cada <doc> enviada, se verifica los campos <ref> y <ref> para saber si el documento existe o hay que agregarlo a la recepción.

Esta modalidad nos permite un flujo de proceso de donde a medida que va llegando información nueva, la misma se envia y se agrega. Los unicos campos que pueden modificarse a-posteriori de crear la recepción, son:

  • <payable>: fecha estimada de cobro
  • <payed>: fecha real de cobro
  • <status>: estado de la recepció. Se sugieren los siguientes campos para informar al Proveedor: RECIBIDO, LISTO PARA COBRAR, FALTA DOCUMENTACION,

Una vez preparado el archivo XML, se puede probar enviando a la siguiente ruta:

curl -u lucas@mephisto.com:knikcata -H ‘Accept: application/xml’ -H ‘Content-Type: application/xml’ -d ‘@nombre_archivo’ http://www.bee2bee.com.ar/syncro/receptions

Tanto el resultado del envio como los posibles fallos, son similares a los de las Notas de Pedido.