DEV Community

fulfillmentyx
fulfillmentyx

Posted on Edited on

Como reconciliar custos de operações de armazém importados de um CSV

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")
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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)