Kosmos Tek
← Blog

Excel a KOSMOS con un clic: envía tus pólizas desde tu hoja de cálculo (sin ser programador)

Si tu contabilidad vive en Excel, no necesitas un sistema nuevo ni un programador. Con una macro, un pequeño programa guardado dentro del propio libro, puedes revisar y enviar las pólizas del mes a KOSMOS Impuestos con un clic.

Pide el Excel de prueba completo: un mes con 46 pólizas listas, una hoja que comprueba que todo cuadre y la macro para importar. Escríbenos a silvano@kosmostek.net y te lo enviamos.

Antes de empezar

  • Excel para Windows. La macro usa un componente que trae Windows; en Excel para Mac no funciona.
  • Tu llave de la API (kha_…, alcance sync), creada en el portal en Seguridad > Llaves de la API.

Paso 1. Prepara el libro

  1. Abre el Excel de prueba que te enviamos, o un libro tuyo con las hojas Config y Polizas.
  2. Ve a Archivo → Guardar como y elige Libro de Excel habilitado para macros (*.xlsm).
  3. Activa la pestaña Programador: Archivo → Opciones → Personalizar cinta de opciones → marca «Programador».

Paso 2. Guarda tu llave fuera del archivo

La llave nunca va dentro del Excel: si compartes el archivo, la compartirías también. Se guarda una sola vez en Windows:

  1. En el menú Inicio escribe variables de entorno y abre «Editar las variables de entorno de esta cuenta».
  2. En Variables de usuario pulsa Nueva. Nombre: KOSMOS_API_KEY. Valor: tu llave.
  3. Acepta y cierra y vuelve a abrir Excel.

Paso 3. Agrega la macro

  1. En la pestaña Programador pulsa Visual Basic.
  2. Archivo → Importar archivo… y elige KOSMOS_Excel.bas, o pega el código de abajo en un módulo nuevo (Insertar → Módulo).
  3. Cierra la ventana de Visual Basic. Listo: la macro ya vive en tu libro.

Paso 4. Llena las hojas

HojaQué va
ConfigB1 = RFC, B2 = año, B3 = mes (1 a 12)
PolizasUna fila por partida: número de póliza, fecha, tipo (I, E o D), descripción, cuenta, cargo y abono. Las partidas de una póliza van juntas con el mismo número.

Cada póliza debe cuadrar (cargos = abonos), tener al menos dos partidas y una descripción de 5 caracteres o más.

Paso 5. Revisa y envía

  1. Programador → Macros → ValidarPolizasKOSMOS → Ejecutar. El portal revisa todo sin guardar nada y te muestra el resultado.
  2. Si hay errores, corrige las filas que te indica y vuelve a validar.
  3. Cuando salga bien, ejecuta EnviarPolizasKOSMOS. Si reenvías el mismo mes, se reemplaza: no se duplica.

Tip: en Programador → Insertar → Botón puedes dibujar dos botones, «Validar» y «Enviar», y asignarles cada macro.

La macro completa

Es corta y está comentada. Si tienes alguien de sistemas cerca, puede revisarla en cinco minutos.

KOSMOS_Excel.bas (VBA)

Attribute VB_Name = "KOSMOS"
' KOSMOS Impuestos: enviar las pólizas de esta hoja de Excel a la API v1.
' Excel para Windows (usa MSXML2.ServerXMLHTTP, incluido en Windows).
'
' Hojas que espera el libro:
'   Config   B1 = RFC, B2 = año, B3 = mes (1 a 12)
'   Polizas  fila 1 = títulos; desde la fila 2:
'            A número | B fecha | C tipo (I, E o D) | D descripción | E cuenta | F cargo | G abono
'            Una fila por partida; las partidas de una misma póliza van juntas y con el mismo número.
'
' La llave NO se escribe en el libro: se lee de la variable de entorno KOSMOS_API_KEY.
Option Explicit

Private Const URL_BASE As String = "https://portal.kosmostek.net/api/v1"

' Revisa el mes con el portal SIN guardar nada. Úsala siempre primero.
Public Sub ValidarPolizasKOSMOS()
    Llamar "/sync/validate"
End Sub

' Envía el mes al portal (reemplaza lo que la API mandó antes para ese mes).
Public Sub EnviarPolizasKOSMOS()
    If MsgBox("¿Enviar las pólizas de " & Hoja("Config").Range("B3").Value & "/" & Hoja("Config").Range("B2").Value & _
              " a KOSMOS? Se reemplaza lo que la API mandó antes para ese mes.", vbYesNo + vbQuestion) = vbYes Then
        Llamar "/sync/batches"
    End If
End Sub

Private Sub Llamar(ruta As String)
    Dim llave As String
    llave = Environ("KOSMOS_API_KEY")
    If llave = "" Then
        MsgBox "Falta la variable de entorno KOSMOS_API_KEY. Ver el paso 2 del instructivo.", vbExclamation
        Exit Sub
    End If

    Dim cuerpo As String
    cuerpo = ArmarLote()
    If cuerpo = "" Then Exit Sub

    Dim http As Object
    Set http = CreateObject("MSXML2.ServerXMLHTTP.6.0")
    http.Open "POST", URL_BASE & ruta, False
    http.setRequestHeader "Authorization", "Bearer " & llave
    http.setRequestHeader "Content-Type", "application/json; charset=utf-8"
    If ruta = "/sync/batches" Then
        http.setRequestHeader "Idempotency-Key", "excel-" & Hoja("Config").Range("B1").Value & "-" & Format(Now, "yyyymmddhhnnss")
    End If
    http.send Utf8(cuerpo)

    MsgBox "KOSMOS respondió " & http.Status & vbCrLf & vbCrLf & Left(http.responseText, 900), _
           IIf(http.Status < 300, vbInformation, vbExclamation)
End Sub

' Arma el lote JSON a partir de la hoja Polizas.
Private Function ArmarLote() As String
    Dim cfg As Worksheet, ws As Worksheet
    Set cfg = Hoja("Config")
    Set ws = Hoja("Polizas")

    Dim json As String, fila As Long, ultima As Long, numero As Variant, abierta As Boolean
    json = "{""rfc"":""" & Texto(cfg.Range("B1").Value) & """,""kind"":""entries"",""mode"":""replace""," & _
           """year"":" & CLng(cfg.Range("B2").Value) & ",""month"":" & CLng(cfg.Range("B3").Value) & ",""items"":["
    ultima = ws.Cells(ws.Rows.Count, "A").End(xlUp).Row
    If ultima < 2 Then
        MsgBox "La hoja Polizas no tiene renglones.", vbExclamation
        Exit Function
    End If

    numero = Empty
    For fila = 2 To ultima
        If ws.Cells(fila, "A").Value <> numero Then
            If abierta Then json = json & "]},"
            numero = ws.Cells(fila, "A").Value
            json = json & "{""number"":" & CLng(numero) & _
                   ",""date"":""" & Format(ws.Cells(fila, "B").Value, "yyyy-mm-dd") & """" & _
                   ",""type"":""" & UCase(Texto(ws.Cells(fila, "C").Value)) & """" & _
                   ",""description"":""" & Texto(ws.Cells(fila, "D").Value) & """,""lines"":["
            abierta = True
        Else
            json = json & ","
        End If
        json = json & "{""account"":""" & Texto(ws.Cells(fila, "E").Value) & """"
        If Val(ws.Cells(fila, "F").Value) <> 0 Then json = json & ",""debit"":" & Importe(ws.Cells(fila, "F").Value)
        If Val(ws.Cells(fila, "G").Value) <> 0 Then json = json & ",""credit"":" & Importe(ws.Cells(fila, "G").Value)
        json = json & "}"
    Next fila
    If abierta Then json = json & "]}"
    ArmarLote = json & "]}"
End Function

' Importe con punto decimal y 2 decimales, sin importar la configuración regional de Windows.
Private Function Importe(v As Variant) As String
    Importe = Replace(Format(CDbl(v), "0.00"), ",", ".")
End Function

' Texto seguro para JSON: escapa diagonales invertidas y comillas.
Private Function Texto(v As Variant) As String
    Texto = Replace(Replace(Trim(CStr(v)), "\", "\\"), """", "\""")
End Function

' Convierte el texto a bytes UTF-8 (acentos y eñes llegan bien al portal).
Private Function Utf8(s As String) As Variant
    Dim st As Object
    Set st = CreateObject("ADODB.Stream")
    st.Type = 2: st.Charset = "utf-8": st.Open
    st.WriteText s
    st.Position = 0: st.Type = 1: st.Position = 3   ' salta la marca BOM de 3 bytes
    Utf8 = st.Read
    st.Close
End Function

Private Function Hoja(nombre As String) As Worksheet
    Set Hoja = ThisWorkbook.Worksheets(nombre)
End Function
Transparencia: la lógica que arma el lote se comprobó con los datos de ejemplo, y produce pólizas cuadradas que cumplen las reglas del portal. La macro todavía no se ha ejecutado dentro de Excel. Pruébala primero con ValidarPolizasKOSMOS, que no guarda nada.

¿Quieres el Excel de prueba o una demostración? silvano@kosmostek.net · +52 55 1397 5173.

¿Programas en otro lenguaje? Tenemos ejemplos en 21 lenguajes.