Скрипт на Python, который превратит выгрузки контактов в чистый CSV, готовый к импорту в ваш сервис рассылок

Пример результата

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Папка: sales/2026-10, найдено файлов: 9
2026-11-02 09:14:03 INFO  shop-01.csv: 1284 строки
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 строк
2026-11-02 09:14:04 WARN  shop-07.csv: пропущены 3 строки без цены (строки 88, 412, 913)
2026-11-02 09:14:05 INFO  Готово: 10 412 строк -> report-2026-10.xlsx (листы «Продажи» и «Итоги»)

[columns]
date = Дата, Дата продажи, День
product = Товар, Наименование, Название
quantity = Кол-во, Количество, Шт
price = Цена, Цена за шт

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Читает файл одного магазина и даёт столбцам названия из отчёта."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: нет столбца «{name}» (искали: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Об услуге

Контакты из магазина, CRM или регистраций на мероприятия редко совпадают с тем, что хочет принять сервис рассылок: другие названия столбцов, имя и фамилия в одной ячейке, теги не на своём месте, отписавшиеся всё ещё в списке. Этот скрипт на Python читает ваши выгрузки и пишет один чистый CSV в макете импорта вашего сервиса: делит имена, если нужно, раскладывает поля и теги, убирает адреса с ошибками и дубли, а начиная со «Стандарта» оставляет только людей с отметкой согласия и убирает отписавшихся, сохраняя отброшенные строки в отдельный файл для проверки. Он для ваших собственных контактов, которые согласились получать от вас письма, и никогда для купленных или собранных с чужих сайтов баз. Работает он на вашем компьютере и к сервису не подключается: файл вы импортируете сами.

Что входит

• Что вы получитеАрхив ZIP со скриптом на Python, README с пошаговой инструкцией и, начиная со «Стандарта», файл настроек с соответствием полей и тегов; код также виден на странице заказа.
• Макет вашего сервисаПо его шаблону импорта или файлу-образцу
• Согласие соблюденоНачиная со «Стандарта», только согласившиеся, без отписавшихся
• Без дублей и ошибокАдреса с ошибками и повторы убираются
• Отброшенное сохраняетсяОтдельный файл с тем, что убрано и почему
• Понятный кодС комментариями, поле легко добавить потом

Порядок работы

1. 1
   ОбразцыВы присылаете выдуманные строки из каждой выгрузки и формат импорта сервиса
2. 2
   КодМы пишем скрипт и инструкцию по запуску
3. 3
   ПроверкаВы запускаете его, просматриваете отброшенные строки и импортируете маленький пробный список
4. 4
   ПравкиВы просите правки в рамках пакета и присылаете текст ошибки, если она есть

Что нужно от вас

Заголовок и 10-20 строк каждой выгрузки с выдуманными именами и адресами, но в том же макете, какой столбец показывает согласие, а какой отписку, сервис рассылок, которым вы пользуетесь, и его шаблон импорта или ссылка на справку по импорту, и как расставлять теги или сегменты. Как собраны контакты (ваш магазин, форма подписки, мероприятия). Настоящую базу не присылайте.

В брифе мы спросим:

• Откуда контакты?
• В какой сервис рассылок импортировать?
• Как отмечено согласие?
• Нужны ли теги или сегменты?

Сравнение пакетов

Вопросы и ответы

Не нашли ответ? Спросите