By YX Fulfillment
O CSV abriu com quatro linhas válidas, mas uma coluna marcada como preço pode ser a tarifa unitária ou o subtotal já multiplicado. Antes de somar, guarde os dois valores e a quantidade, e registre a moeda que aparece no cabeçalho.
O exemplo público da YX Fulfillment tem quatro linhas em CNY: abertura de uma ordem de entrada, medição de cinco tipos de SKU, etiquetagem de cem unidades e preparação de cem pacotes. A tabela informa 382,50 CNY como subtotal do manuseio. Os dois CSVs abaixo transcrevem os mesmos números. O segundo troca o separador de campo para ponto e vírgula e usa a vírgula decimal. A moeda foi trazida do cabeçalho para cada linha.
O exemplo roda em Python 3, sem dependências externas.
import csv
from decimal import Decimal, ROUND_HALF_UP
from io import StringIO
import re
EN = """operacao,quantidade,tarifa,subtotal,moeda
entrada,1,10.00,10.00,CNY
medicao,5,0.50,2.50,CNY
etiquetagem,100,0.20,20.00,CNY
preparacao,100,3.50,350.00,CNY"""
PT = """operacao;quantidade;tarifa;subtotal;moeda
entrada;1;10,00;10,00;CNY
medicao;5;0,50;2,50;CNY
etiquetagem;100;0,20;20,00;CNY
preparacao;100;3,50;350,00;CNY"""
def parse_decimal(text, decimal_separator):
pattern = rf"[0-9]+(?:{re.escape(decimal_separator)}[0-9]+)?"
if not re.fullmatch(pattern, text):
raise ValueError(f"valor fora da localidade: {text}")
return Decimal(text.replace(decimal_separator, "."))
def line_total(quantity, unit_rate, currency, decimal_separator):
if currency != "CNY":
raise ValueError("moeda CNY ausente ou incompatível")
unit = parse_decimal(unit_rate, decimal_separator)
return (Decimal(quantity) * unit).quantize(Decimal("0.01"), ROUND_HALF_UP)
def reconcile(source, field_separator, decimal_separator):
total = Decimal("0.00")
for line in csv.DictReader(StringIO(source), delimiter=field_separator):
result = line_total(int(line["quantidade"]), line["tarifa"],
line["moeda"], decimal_separator)
shown = parse_decimal(line["subtotal"], decimal_separator)
if result != shown:
raise ValueError(f"subtotal divergente: {line['operacao']}")
total += result
return total
print("CSV com ponto:", reconcile(EN, ",", "."))
print("CSV com vírgula:", reconcile(PT, ";", ","))
print("quantidade zero:", line_total(0, "3,50", "CNY", ","))
print("arredondamento de teste:", line_total(3, "0,335", "CNY", ","))
try:
line_total(1, "3,50", "", ",")
except ValueError as error:
print("rejeição:", error)
assert reconcile(EN, ",", ".") == reconcile(PT, ";", ",") == Decimal("382.50")
assert line_total(0, "3,50", "CNY", ",") == Decimal("0.00")
assert line_total(3, "0,335", "CNY", ",") == Decimal("1.01")
Totais conferidos com a moeda de origem
CSV com ponto: 382.50
CSV com vírgula: 382.50
quantidade zero: 0.00
arredondamento de teste: 1.01
rejeição: moeda CNY ausente ou incompatível
O caso de 0,335 é sintético. A regra escolhida aqui é multiplicar primeiro e arredondar cada linha a duas casas com ROUND_HALF_UP. Se a regra do contrato arredondar só o total, o teste precisa representar essa outra política. O parser admite apenas um separador decimal por arquivo e rejeita agrupamentos de milhar para evitar interpretar 1.234 sem contexto.
Os 382,50 CNY conferem com a tabela pública. O exemplo abrange o manuseio indicado e exclui armazenagem, materiais de embalagem, frete internacional, tributos, descarga e trabalho extra. Em uma importação real, preserve a moeda, a origem e a data da tabela, além de exibir separadamente o preço por unidade e o subtotal calculado.
Fonte da amostra YX Fulfillment
https://fulfillmentyx.com/pricing
Top comments (0)