Communitygithub.com

Operaciones de Facturación de Clientes

Opera flujos de trabajo de facturación de clientes, como suscripciones, reembolsos, triaje de cancelaciones, recuperación del portal de facturación y análisis de planes, utilizando herramientas de facturación conectadas como Stripe. Úsalo cuando el usuario necesite ayudar a un cliente, inspeccionar el estado de la suscripción o gestionar operaciones de facturación que afecten los ingresos.

¿Qué es Operaciones de Facturación de Clientes?

Esta habilidad está diseñada para operadores que gestionan consultas y problemas reales de facturación de clientes, no para el diseño genérico de APIs de pago. Se enfoca en identificar al cliente, clasificar el problema (duplicados, fallos de pago, etc.), tomar la acción reversible más segura (como restaurar el autoservicio o reembolsar solo el cargo duplicado) y documentar el cierre. Es compatible con plataformas como Stripe para acciones directas de facturación, y utiliza correo electrónico o GitHub solo como evidencia de respaldo. La habilidad incluye salvaguardas para no exponer datos sensibles, no reembolsar a ciegas y verificar contratos (planes anuales, de equipo) antes de actuar. Finalmente, produce un resumen estandarizado con el estado del cliente, las acciones tomadas, el impacto en los ingresos y cualquier brecha del producto que deba registrarse en el backlog.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/customer-billing-ops

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Operaciones de Facturación de Clientes?

Usa esta habilidad para operaciones reales con clientes, no para el diseño genérico de APIs de pago.

El objetivo es ayudar al operador a responder: quién es este cliente, qué pasó, cuál es la solución más segura y qué seguimiento debemos enviar.

Cuándo Usarlo

  • El cliente dice que la facturación está rota, quiere un reembolso o no puede cancelar
  • Investigar suscripciones duplicadas, cargos accidentales, renovaciones fallidas o riesgo de cancelación
  • Revisar la combinación de planes, suscripciones activas, conversión anual vs mensual, o confusión con asientos de equipo
  • Crear o validar un flujo de portal de facturación
  • Auditar quejas de soporte que involucren suscripciones, facturas, reembolsos o métodos de pago

Superficie de Herramientas Preferida

  • Usa primero herramientas de facturación conectadas como Stripe
  • Usa correo electrónico, GitHub o rastreadores de incidencias solo como evidencia de apoyo
  • Prefiere portales de facturación/cliente alojados sobre código personalizado de gestión de cuentas cuando la plataforma ya proporciona los controles necesarios

Salvaguardas

  • Nunca expongas claves secretas, detalles completos de tarjetas ni PII innecesaria del cliente en la respuesta
  • No reembolses a ciegas; primero clasifica el problema
  • Distingue entre:
    • compra duplicada accidental
    • compra deliberada de múltiples asientos o equipo
    • producto defectuoso / valor no cumplido
    • proceso de pago fallido o incompleto
    • cancelación debido a falta de controles de autoservicio
  • Para planes anuales, planes de equipo y estados prorrateados, verifica la forma del contrato antes de actuar

Flujo de Trabajo

1. Identificar al cliente de forma limpia

Comienza desde el identificador más sólido disponible:

  • correo electrónico del cliente
  • ID de cliente de Stripe
  • ID de suscripción
  • ID de factura
  • nombre de usuario de GitHub o correo electrónico de soporte si se sabe que se asigna a la facturación

Devuelve un resumen de identidad conciso:

  • cliente
  • suscripciones activas
  • suscripciones canceladas
  • facturas
  • anomalías evidentes como suscripciones activas duplicadas

2. Clasificar el problema

Clasifica el caso en un solo cubo antes de actuar:

CasoAcción típica
Suscripción personal duplicadacancelar extras, considerar reembolso
Intención real de múltiples asientos/equipopreservar asientos, aclarar modelo de facturación
Pago fallido / proceso de pago incompletorecuperar a través del portal o actualizar método de pago
Falta de controles de autoservicioproporcionar portal, ruta de cancelación o acceso a facturas
Falla del producto o ruptura de confianzareembolsar, disculpar, registrar problema del producto

3. Tomar la acción reversible más segura primero

Orden preferido:

  1. restaurar la gestión de autoservicio
  2. corregir el estado de facturación duplicado o roto
  3. reembolsar solo el cargo afectado o duplicado
  4. documentar el motivo
  5. enviar un breve seguimiento al cliente

Si la corrección requiere trabajo de producto, separa:

  • remediación del cliente ahora
  • error del producto / brecha en el flujo de trabajo para el backlog

4. Verificar brechas de producto del lado del operador

Si el dolor del cliente proviene de una superficie faltante para el operador, menciónalo explícitamente. Ejemplos comunes:

  • sin portal de facturación
  • sin visibilidad de uso/límites de velocidad
  • sin explicación de plan/asiento
  • sin flujo de cancelación
  • sin protección contra suscripciones duplicadas

Trátalos como elementos de seguimiento de ECC o sitio web, no solo como incidentes de soporte.

5. Producir el traspaso para el operador

Termina con:

  • resumen del estado del cliente
  • acción tomada
  • impacto en los ingresos
  • texto de seguimiento para enviar
  • problema de producto o backlog para crear

Formato de Salida

Usa esta estructura:

CLIENTE
- nombre / correo electrónico
- identificadores de cuenta relevantes

ESTADO DE FACTURACIÓN
- suscripciones activas
- estado de factura o renovación
- anomalías

DECISIÓN
- clasificación del problema
- por qué esta acción es correcta

ACCIÓN TOMADA
- reembolso / cancelación / portal / sin operación

SEGUIMIENTO
- mensaje corto al cliente

BRECHA DE PRODUCTO
- qué se debe corregir en el producto o sitio web

Ejemplos de Buenas Recomendaciones

  • "La solución correcta es un portal de facturación, no un panel personalizado todavía"
  • "Esto parece un proceso de pago personal duplicado, no una compra real de asientos de equipo"
  • "Reembolsa un cargo duplicado, mantén la suscripción activa restante, luego convierte al cliente a facturación de organización más adelante si es necesario"

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

Skills relacionados