BRIDGE API - Rabbit - Exportación de un documento de inventario



© 2024 Napse. Todos los derechos reservados.

REVISIONES
FechaVersiónDescripciónAutor

 

1.1Se agrega descripción a campos

Andrea Veronica Asato 



CONTENIDO



Introducción 

Documentos de  inventario 

Este servicio posee la descripción de un documento de inventario generado en una tienda. que se genera para ser exportado y posteado en una cola Rabbit con formato JSON.

  • La habilitación del envío de este tipo de transacción se podrán configurar desde Configuración/colas de exportación


Se adjunta un ejemplo en formato JSON a modo de referencia.

El tipo de documento de inventario será: 

#Tipo de documento a exportarEstado en el cual se exportará
1InventoryOrder (Orden de compra)

En el caso de una Orden de compra, la misma se exportará cuando su estado sea CONFIRMADA, ENTREGA PARCIAL, CERRADA, CANCELADA

  • CONFIRMADA (Code: 2,)
  • ENTREGA PACIAL (Code: 3)
  • CERRADA (Code: 4)
  • CANCELADA (Code: 5)
2InventoryReception (Recepción)

En el caso de una recepción se exportará cuando su estado sea CERRADA o PENDIENTE IMPUTACION. Se utiliza tanto para la recepción de orden de compra, recepción de transferencia, o nueva recepción

  • PENDIENTE IMPUTACION (Code: 7)
  • CERRADA (Code: 4)
3InventoryReturn (Devolución a proveedor)

En el caso de una devolución se exportará cuando su estado sea CERRADA o PENDIENTE IMPUTACION. 

  • PENDIENTE IMPUTACION (Code: 7)
  • CERRADA (Code: 4)
4InventoryTransferOrder (Orden de transferencia)

En el caso de una orden de transferencia generada desde tienda destino se exportará cuando su estado sea CONFIMADA (cuando se crea), ENTREGA PARCIAL (cuando la orden se recibe parcialmente), CERRADA (cuando la orden se recibe por completo), CANCELADA (Cuando una orden confirmada se cancela)

  • CONFIRMADA (Code: 2)
  • CERRADA (Code: 4)
  • ENTREGA PARCIAL (Code: 3)
  • CANCELADA (Code: 5)
5InventoryTransfer (Transferencia)

En el caso de una transferencia generada desde tienda origen (puedo o no estar asociada a una orden de transferencia) se exportará cuando su estado sea CONFIMADA (cuando se crea), CERRADA (cuando se recibe), CANCELADA (Cuando una transferencia se cancela)

  • CONFIRMADA (Code: 2)
  • CERRADA (Code: 4)
  • CANCELADA (Code: 5)
6InventoryAdjustment (Ajuste de invetario)

En el caso de un ajuste de inventario  (puedo o no estar asociado a un conteo) se exportará cuando su estado sea CONFIMADO 

  • CONFIRMADO (Code: 2)
7InventoryFiscalDoc (ASN o documento fiscal )



JSON ejemplo

JSON ejemplo

{
   "period":1,
   "subperiod":2,
   "sourceRetailStoreCode":"Unicenter",
   "destinationRetailStoreCode":"Unicenter",
   "userName":"Juan Perez",
   "userCode":"juanp",
   "serialFormId":"3363000002",
   "createdAt":"2021-06-09T19:08:57.696Z",
   "supplierCode":"PR1",
   "expectedDeliveryDate":"2021-06-09T19:08:51.810Z",
   "inventoryControlDocumentStateCode":2,
   "inventoryControlDocumentStateName":"CONFIRMADA",
   "documentTypeCode":"InventoryOrder",
   "receiptType":"factura",
   "receiptNumber":"A-00001-00000001",
   "receiptDate":"2021-06-09T04:01:00.000Z",
   "cAIDate":"2021-06-09T19:08:51.810Z",
   "cAINumber":0,
   "icdAmount":2000.0000,
   "icdQuantity":1.0000,
   "icdTotSalesAmount":4000.0000,
   "orderDocumentTypeCode":"1",
   "contractReferenceNumber":"125412",
   "frequency":10,
   "inventoryAdjustmentTypeCode":"",
   "differencialVATAmount":"0.000",
   "exemptAmount":"0.000",
   "iIBBTaxAmount":"0.000",
   "iVATaxAmount":"0.000",
   "netAmount":"0.000",
   "taxAmount":"0.000",
   "totalAmount":"0.000",
   "vatAmount":"0.000",
   "exemptAmout":"0.000",
   "vATAmount":"0.000",
   "InventoryControlDocumentLineItem":[
      {
         "costTotalAmount":"2000.0000",
         "unitBaseCostAmount":2000.0000,
         "sourceLocationCode":"DEP1",
         "suggestedPurchaseOrder":10.0000,
         "itemBrand":"SONY",
         "unitCount":1.0000,
         "dailyAverageSales":0.8000,
         "destinationLocationCode":"DEP1",
         "uomUnits":1,
         "itemCode":"12098",
         "stock":0.0000,
         "salesTotalAmount":0.0000,
         "itemDescription":"Auricular Blutooh",
         "minOrder":1.0000,
         "unitSalesAmount":4000.0000,
         "unitCountReceive":0.0000,
         "barcodes":null,
         "inventoryControlDocumentMerchandiseSerializedUnits":[
            {
               "unitCount":1,
               "serializedUnitCode":"7988-SM-A715FZSLARO-11",
               "importDocNumber":"0005LIBERADO",
               "received":false,
               "serialNumber":"0005LIBERADO1010"
            }
         ]
      }
   ]
}

Detalle de los campos del JSON del documento de inventario 

Campo

Tipo

Descripción

Documento de inventario

_id

string

Uso interno

TODAS

cAIDate

Date

Fecha del CAI del documento que se presente (factura / recepción)

ASN

createdAt

Date

Fecha de creación del documento

TODAS

expectedDeliveryDate

Date

Fecha estimada para entrega

OC

period

Number

Período de la operación de inventario

TODAS

periodCodeNumberCódigo del periodo de la operación de inventarioTODAS

receiptDate

Date

Fecha del documento fiscal que se presente (factura / recepción)

RECEPCION - DEVOLUCION - ASN

subperiod

Number

Subperíodo de la operación de inventario

TODAS

subperiodCodeNumberCódigo del subperiodo de la operación de inventarioTODAS

inventoryControlDocumentLineItem

List



_class

string

Uso interno de Bridge


barcodes

StringCódigo de barras RECEPCION - DEVOLUCION - ASN

costTotalAmount

Decimal

Monto total del costo del artículo (costo por cantidad)

TODAS

createdAt

Date

Fecha de creación del documento

TODAS

dailyAverageSales

Decimal

Promedio de ventas diarias

OC

destinationLocation

String

Depósito destino (aplica a Transferencias)

TRANSFERENCIAS

differenceBMAsnType

StringMotivo de diferenecia de cantidades en la recepción de una ASNRECEPCION - DEVOLUCION

inventoryControlDocument

String

uso interno de Bridge


inventoryControlDocumentLineItemOrder

IntegerUtilizado para ordenar los articulos que llegan en la facturaASN

inventoryControlDocumentMerchandiseSerializedUnits

List

RECEPCIÓN - DEVOLUCIÓN - ASN - TRANSFERENCIA - AJUSTE

unitCount

Decimal

Cantidad del artículo


deleted

boolean

 uso interno de Bridge


customsDate

Date

Fecha aduana


serializedUnitCode

string

Código interno de bridge conformado por SERIALIZABLE_serialNumber


customsNumber

string

Número de la aduana


importDocNumber

string

Número del documento de importación


received

boolean

Indicativo de si es recibido o no


serialNumber

string

Número que identifica la serie


item

String

Artículos

TODAS

itemBrand

String

Marca del artículo

TODAS

itemDescription

String

Descripción del artículo

TODAS

lastUpdateDate

Date

última fecha de actualización

TODAS

minOrder

String

Indica la cantidad mínima para ordenar

OC

          parentKitstringEs producto padreTODAS

previousStock

Decimal

Stock previo

TODAS

salesTotalAmount

Decimal

Monto total de venta del artículo

TODAS

sourceLocation (CODE)

string

Depósito de origen

TODAS

          stockDecimalStock del itemTODAS

stockPickupType

stringNO UTILIZADO

suggestedPurchaseOrder

Decimal

Cantidad sugerida para el proveedor

OC

          textstringNO UTILIZADO

unitBaseCostAmount

Decimal

Precio de costo del artículo

TODAS

unitCount

Decimal

Cantidad del artículo

TODAS

unitCountReceive

Decimal

Cantidad de unidades recibidas

OC

unitSalesAmount

Decimal

Precio unitario de venta del artículo

TODAS

uomUnits

Decimal

Unidades de medida

TODAS

updatedAt

Date

Fecha de actualización del documento

TODAS

versionnumberInterno de Bridge

InventoryControlDocumentReference

Lista

Lista de documentos asociados con su fecha y tipo de documento

TODAS (Dependiendo si tienen otros documentos de inventario asociados)

          _idstringInterno de Bridge
          createdAtdateFecha de creación del documento
          idstringInterno de Bridge

          referToInventoryControlDocumentNumber

stringNúmero del documento de inventario asoociado (generado autmanticamente por Bridge)
          referToInventoryControlDocumentTypestringTipo del documento de inventario asoociado (generado autmanticamente por Bridge)

          updatedAt

date

Fecha de actualización del documento


          version

numberinterno de Bridge

sourceRetailStoreCode

String

Código de la tienda origen del documento de inventario

TODAS

destinationRetailStoreCode

String

Código de la tienda destino del documento de inventario

TODAS

userName

String

Nombre del usuario que crea el documento de inventario

TODAS

serialFormId

String

Nro del documento de inventario (generado automáticamente por BRIDGE)

TODAS

supplierCode

String

Código del proveedor

OC - RECEPCION - DEVOLUCION - ASN

inventoryControlDocumentStateCode

String

Código del estado del documento de inventario

Estados posibles:

1: ABIERTA

2: CONFIRMADA

3: ENTREGA PARCIAL

4: CERRADA

5: CANCELADA

7: PENDIENTE IMPUTACION

8: PENDIENTE RECEPCION

12: RECEPCION PARCIAL

TODAS

inventoryControlDocumentStateName

String

Nombre del estado del documento de inventario

TODAS

documentTypeCode

String

Tipo de documento

TODAS

cAINumber

Number

Nro de CAI del documento que se presente (factura / recepción)

ASN

icdAmount

Decimal

Monto del documento (costo)

TODAS

icdQuantity

Decimal

Cantidad de unidades de los items que integran el documento

TODAS

icdTotSalesAmount

Decimal

Monto total de venta del documento

TODAS

frequency

Number

Cantidad de días entre pedidos del proveedor (aplica a Orden de compra)


OC 

inventoryAdjustmentTypeCode

string

Tipo de ajuste

Valores posibles:

UNJUSTIFIED_DEPLETIONS (mermas no justificadas)

UNJUSTIFIED_ADJUSTMENTS (ajustes no justificados)

JUSTIFIED_DEPLETIONS (mermas justificadas)

JUSTIFIED_ADJUSTMENTS (ajustes justificados)

CORRECTIVE_ADJUSTMENT (ajustes correctivos)

Sólo aplica para ajustes de inventario

CONTEO - AJUSTE

differencialVATAmount

Decimal

IVA Diferencial 

ASN

exemptAmount

Decimal 

Valor Exento

ASN

iIBBTaxAmount

Decimal

Percepción IIBB

ASN

iVATaxAmount

Decimal

Percepción IVA 

ASN

netAmount

Decimal

Estos campos de totales se informarán si se asocia un comprobante fiscal (ej: recepción de ASN)

ASN

taxAmount

Decimal

Impuestos Internos

ASN

totalAmount

Decimal

Total, del documento fiscal presentado

ASN

vatAmount

Decimal

IVA Base

ASN


La entidad inventoryControlDocumentSerializedLineItem informa por cada nro de serie y/o despacho que pudiera tener un artículo. El mismo posee la siguiente estructura:

Campo

Tipo

Descripción

"unitCount"DecimalCantidad de unidades (en el caso de ítems con serie siempre será 1, en el caso de lote o despacho pueden ser mayor a 1)

"serializedUnitCode"

String

Nro serializable

"importDocNumber"

String

Nro. de pedimento

"serialNumber"

String

Nro. de serie

"customsDate"

Date

Fecha del despacho

"received"BooleanIndicador si fue recibido o no el serie/despacho



  • Sem rótulos