Introdução ao Retail Search - Gestão de inventário

 

Conforme o fluxo de vendas é possível que os produtos acabem e precisem ser renovados, para alterar essa parte podemos utilizar os atributos de inventário:

Os campos Product a seguir são considerados campos de inventário:

• Product.price_info
• Product.availability
• Product.available_quantity
• Product.fulfillment_info

Utilizamos os metodos de fulfillment para alterar essas informações.

Exemplo de código Adição:

import datetime
import random
import string
import time

import google.auth
from google.cloud.retail import AddFulfillmentPlacesRequest, ProductServiceClient

from setup_product.setup_cleanup import create_product, delete_product, get_product

project_id = google.auth.default()[1]
product_id = "".join(random.sample(string.ascii_lowercase, 8))
product_name = (
    "projects/"
    + project_id
    + "/locations/global/catalogs/default_catalog/branches/default_branch/products/"
    + product_id
)

# add fulfillment request
def get_add_fulfillment_request(
    product_name: str, timestamp, place_id
) -> AddFulfillmentPlacesRequest:
    add_fulfillment_request = AddFulfillmentPlacesRequest()
    add_fulfillment_request.product = product_name
    add_fulfillment_request.type_ = "pickup-in-store"
    add_fulfillment_request.place_ids = [place_id]
    add_fulfillment_request.add_time = timestamp
    add_fulfillment_request.allow_missing = True

    print("---add fulfillment request---")
    print(add_fulfillment_request)

    return add_fulfillment_request

# add fulfillment places to product
def add_fulfillment_places(product_name: str, timestamp, place_id):
    add_fulfillment_request = get_add_fulfillment_request(
        product_name, timestamp, place_id
    )
    ProductServiceClient().add_fulfillment_places(add_fulfillment_request)

    # This is a long running operation and its result is not immediately present with get operations,
    # thus we simulate wait with sleep method.
    print("---add fulfillment places, wait 90 seconds :---")
    time.sleep(90)

# [END retail_add_fulfillment_places]

create_product(product_id)

# The request timestamp
current_date = datetime.datetime.now() + datetime.timedelta(seconds=30)
print(f"------add fulfilment places with current date: {current_date}-----")
add_fulfillment_places(product_name, current_date, "store2")
get_product(product_name)
delete_product(product_name)

Exemplo de código Remoção:

import datetime
import random
import string
import time

from google.cloud.retail import ProductServiceClient, RemoveFulfillmentPlacesRequest

from setup_product.setup_cleanup import create_product, delete_product, get_product

product_id = "".join(random.sample(string.ascii_lowercase, 8))

# remove fulfillment request
def get_remove_fulfillment_request(
    product_name: str, timestamp, store_id
) -> RemoveFulfillmentPlacesRequest:
    remove_fulfillment_request = RemoveFulfillmentPlacesRequest()
    remove_fulfillment_request.product = product_name
    remove_fulfillment_request.type_ = "pickup-in-store"
    remove_fulfillment_request.place_ids = [store_id]
    remove_fulfillment_request.remove_time = timestamp
    remove_fulfillment_request.allow_missing = True

    print("---remove fulfillment request---")
    print(remove_fulfillment_request)

    return remove_fulfillment_request

# remove fulfillment places to product
def remove_fulfillment_places(product_name: str, timestamp, store_id):
    remove_fulfillment_request = get_remove_fulfillment_request(
        product_name, timestamp, store_id
    )
    ProductServiceClient().remove_fulfillment_places(remove_fulfillment_request)

    # This is a long running operation and its result is not immediately present with get operations,
    # thus we simulate wait with sleep method.
    print("---remove fulfillment places, wait 90 seconds:---")
    time.sleep(90)

# [END retail_remove_fulfillment_places]

product = create_product(product_id)

# The request timestamp
current_date = datetime.datetime.now()

print(f"------remove fulfilment places with current date: {current_date}-----")
remove_fulfillment_places(product.name, current_date, "store0")
get_product(product.name)
delete_product(product.name)

Exemplo de código atualização:

import datetime
import random
import string
import time

import google.auth
from google.cloud.retail import (
    FulfillmentInfo,
    PriceInfo,
    Product,
    ProductServiceClient,
    SetInventoryRequest,
)
from google.protobuf.field_mask_pb2 import FieldMask

from setup_product.setup_cleanup import create_product, delete_product, get_product

project_id = google.auth.default()[1]
product_id = "".join(random.sample(string.ascii_lowercase, 8))
product_name = (
    "projects/"
    + project_id
    + "/locations/global/catalogs/default_catalog/branches/default_branch/products/"
    + product_id
)

# product inventory info
def get_product_with_inventory_info(product_name: str) -> Product:
    price_info = PriceInfo()
    price_info.price = 15.0
    price_info.original_price = 60.0
    price_info.cost = 8.0
    price_info.currency_code = "USD"

    fulfillment_info = FulfillmentInfo()
    fulfillment_info.type_ = "pickup-in-store"
    fulfillment_info.place_ids = ["store1", "store2"]

    product = Product()
    product.name = product_name
    product.price_info = price_info
    product.fulfillment_info = [fulfillment_info]
    product.availability = "IN_STOCK"

    return product

# set inventory request
def get_set_inventory_request(product_name: str) -> SetInventoryRequest:
    # The request timestamp
    request_time = datetime.datetime.now() + datetime.timedelta(seconds=30)
    set_mask = FieldMask(
        paths=["price_info", "availability", "fulfillment_info", "available_quantity"]
    )

    set_inventory_request = SetInventoryRequest()
    set_inventory_request.inventory = get_product_with_inventory_info(product_name)
    set_inventory_request.set_time = request_time
    set_inventory_request.allow_missing = True
    set_inventory_request.set_mask = set_mask

    print("---set inventory request---")
    print(set_inventory_request)

    return set_inventory_request

# set inventory to product
def set_inventory(product_name: str):
    set_inventory_request = get_set_inventory_request(product_name)
    ProductServiceClient().set_inventory(set_inventory_request)

    # This is a long running operation and its result is not immediately present with get operations,
    # thus we simulate wait with sleep method.
    print("---set inventory, wait 90 seconds:---")
    time.sleep(90)

create_product(product_id)
set_inventory(product_name)
get_product(product_name)
delete_product(product_name)

Referências:

https://cloud.google.com/retail/docs/inventory-updates?hl=pt-br