{
  "openapi": "3.0.0",
  "paths": {
    "/partners/v1/auth/login": {
      "post": {
        "operationId": "partnersV1AuthLogin",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Obtener token de acceso",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "secret": {
                    "type": "string"
                  }
                },
                "required": [
                  "key",
                  "secret"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "access_token": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "access_token"
                      ]
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "La llave o el secreto no son válidos.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "La llave no tiene perfil o empresa asignados.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Autenticación"
        ],
        "description": "Con la llave y el secreto que te entrega el equipo de Openbox Cloud.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/invoices/sellers": {
      "post": {
        "operationId": "partnersV1InvoicesSellersCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear vendedor",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "UUID de Openbox Cloud propuesto por el integrador (8-4-4-4-12 por forma). Omitido: lo genera Openbox Cloud."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: sin internalId."
                  },
                  "name": {
                    "type": "string"
                  },
                  "zone": {
                    "type": "string",
                    "description": "Zona del vendedor por referencia (UUID de Openbox Cloud)."
                  },
                  "dui": {
                    "type": "string",
                    "nullable": true
                  }
                },
                "required": [
                  "name",
                  "zone"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "zone": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name"
                      ],
                      "nullable": true,
                      "description": "Zona del vendedor. `null` si su zona fue eliminada: asígnale otra con un PATCH que envíe `zone`."
                    },
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "dui": {
                      "type": "string",
                      "nullable": true
                    }
                  },
                  "required": [
                    "zone",
                    "id",
                    "internalId",
                    "name",
                    "dui"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato (validación), o la zona que citas en zone no existe en tu empresa o fue eliminada (code REFERENCE_NOT_FOUND). Estos 400 llegan antes de escribir nada.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe un registro activo con ese internalId en tu empresa, o el id que enviaste ya existe (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Vendedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Agrega un registro nuevo al catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1InvoicesSellersGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Listar vendedores",
        "parameters": [
          {
            "name": "internalId",
            "required": false,
            "in": "query",
            "description": "Filtra por la referencia externa del integrador (coincidencia exacta, sensible a mayúsculas).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Página (desde 1). Por omisión 1.",
            "schema": {
              "minimum": 1,
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Registros por página (1 a 100). Por omisión 20.",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "zone": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name"
                            ],
                            "nullable": true,
                            "description": "Zona del vendedor. `null` si su zona fue eliminada: asígnale otra con un PATCH que envíe `zone`."
                          },
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string",
                            "nullable": true
                          },
                          "name": {
                            "type": "string"
                          },
                          "dui": {
                            "type": "string",
                            "nullable": true
                          }
                        },
                        "required": [
                          "zone",
                          "id",
                          "internalId",
                          "name",
                          "dui"
                        ]
                      }
                    },
                    "count": {
                      "type": "number"
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "data",
                    "count",
                    "page",
                    "limit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Vendedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Con filtro opcional por tu internalId.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/invoices/sellers/{id}": {
      "get": {
        "operationId": "partnersV1InvoicesSellersGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar vendedor",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "zone": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name"
                      ],
                      "nullable": true,
                      "description": "Zona del vendedor. `null` si su zona fue eliminada: asígnale otra con un PATCH que envíe `zone`."
                    },
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "dui": {
                      "type": "string",
                      "nullable": true
                    }
                  },
                  "required": [
                    "zone",
                    "id",
                    "internalId",
                    "name",
                    "dui"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El vendedor no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Vendedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "patch": {
        "operationId": "partnersV1InvoicesSellersUpdateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Actualizar vendedor",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: la quita."
                  },
                  "name": {
                    "type": "string"
                  },
                  "zone": {
                    "type": "string",
                    "description": "Zona del vendedor por referencia (UUID de Openbox Cloud)."
                  },
                  "dui": {
                    "type": "string",
                    "nullable": true,
                    "description": "DUI del vendedor. `null`: lo limpia."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "zone": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name"
                      ],
                      "nullable": true,
                      "description": "Zona del vendedor. `null` si su zona fue eliminada: asígnale otra con un PATCH que envíe `zone`."
                    },
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "dui": {
                      "type": "string",
                      "nullable": true
                    }
                  },
                  "required": [
                    "zone",
                    "id",
                    "internalId",
                    "name",
                    "dui"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato (validación), o la zona que citas en zone no existe en tu empresa o fue eliminada (code REFERENCE_NOT_FOUND). Estos 400 llegan antes de escribir nada.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El vendedor no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Otro registro activo de tu empresa ya usa ese internalId (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Vendedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Actualización parcial: solo cambian los campos que envíes.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "delete": {
        "operationId": "partnersV1InvoicesSellersDeleteSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Eliminar vendedor",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "message"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El vendedor no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Vendedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Quita el registro del catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/invoices/zones": {
      "post": {
        "operationId": "partnersV1InvoicesZonesCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear zona",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "UUID de Openbox Cloud propuesto por el integrador (8-4-4-4-12 por forma). Omitido: lo genera Openbox Cloud."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: sin internalId."
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe un registro activo con ese internalId en tu empresa, o el id que enviaste ya existe (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Zonas"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Agrega un registro nuevo al catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1InvoicesZonesGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Listar zonas",
        "parameters": [
          {
            "name": "internalId",
            "required": false,
            "in": "query",
            "description": "Filtra por la referencia externa del integrador (coincidencia exacta, sensible a mayúsculas).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Página (desde 1). Por omisión 1.",
            "schema": {
              "minimum": 1,
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Registros por página (1 a 100). Por omisión 20.",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string",
                            "nullable": true
                          },
                          "name": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "internalId",
                          "name"
                        ]
                      }
                    },
                    "count": {
                      "type": "number"
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "data",
                    "count",
                    "page",
                    "limit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Zonas"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Con filtro opcional por tu internalId.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/invoices/zones/{id}": {
      "get": {
        "operationId": "partnersV1InvoicesZonesGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar zona",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La zona no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Zonas"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "patch": {
        "operationId": "partnersV1InvoicesZonesUpdateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Actualizar zona",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: la quita."
                  },
                  "name": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La zona no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Otro registro activo de tu empresa ya usa ese internalId (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Zonas"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Actualización parcial: solo cambian los campos que envíes.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "delete": {
        "operationId": "partnersV1InvoicesZonesDeleteSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Eliminar zona",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "message"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La zona no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "La zona tiene vendedores asignados (activos o inactivos) y no se elimina. Este 409 no trae code.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Zonas"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Quita el registro del catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/invoices/payment-conditions": {
      "post": {
        "operationId": "partnersV1InvoicesPaymentConditionsCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear condición de pago de venta",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "UUID de Openbox Cloud propuesto por el integrador (8-4-4-4-12 por forma). Omitido: lo genera Openbox Cloud."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: sin internalId."
                  },
                  "name": {
                    "type": "string"
                  },
                  "cashPayment": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "name",
                  "cashPayment"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "cashPayment": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "cashPayment"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe un registro activo con ese internalId en tu empresa, o el id que enviaste ya existe (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de venta"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Agrega un registro nuevo al catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1InvoicesPaymentConditionsGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Listar condiciones de pago de venta",
        "parameters": [
          {
            "name": "internalId",
            "required": false,
            "in": "query",
            "description": "Filtra por la referencia externa del integrador (coincidencia exacta, sensible a mayúsculas).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Página (desde 1). Por omisión 1.",
            "schema": {
              "minimum": 1,
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Registros por página (1 a 100). Por omisión 20.",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string",
                            "nullable": true
                          },
                          "name": {
                            "type": "string"
                          },
                          "cashPayment": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "internalId",
                          "name",
                          "cashPayment"
                        ]
                      }
                    },
                    "count": {
                      "type": "number"
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "data",
                    "count",
                    "page",
                    "limit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de venta"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Con filtro opcional por tu internalId.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/invoices/payment-conditions/{id}": {
      "get": {
        "operationId": "partnersV1InvoicesPaymentConditionsGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar condición de pago de venta",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "cashPayment": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "cashPayment"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La condición de pago no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de venta"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "patch": {
        "operationId": "partnersV1InvoicesPaymentConditionsUpdateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Actualizar condición de pago de venta",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: la quita."
                  },
                  "name": {
                    "type": "string"
                  },
                  "cashPayment": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "cashPayment": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "cashPayment"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La condición de pago no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Otro registro activo de tu empresa ya usa ese internalId (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de venta"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Actualización parcial: solo cambian los campos que envíes.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "delete": {
        "operationId": "partnersV1InvoicesPaymentConditionsDeleteSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Eliminar condición de pago de venta",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "message"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La condición de pago no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de venta"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Quita el registro del catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/invoices": {
      "post": {
        "operationId": "partnersV1InvoicesCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear venta",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "settings": {
                    "type": "object",
                    "properties": {
                      "notify": {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          "EMAIL",
                          "NONE"
                        ]
                      },
                      "internalId": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "notify"
                    ]
                  },
                  "data": {
                    "type": "object",
                    "properties": {
                      "header": {
                        "type": "object",
                        "properties": {
                          "customer": {
                            "description": "UUID de Openbox Cloud del registro (referencia) u objeto completo.",
                            "oneOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
                                "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "branch": {
                                    "type": "object",
                                    "properties": {
                                      "country": {
                                        "type": "string",
                                        "pattern": "^(\\d{4}|[A-Za-z]{2})$",
                                        "description": "SVCode de 4 dígitos o código ISO 3166-1 alfa-2 (ej. \"PA\"), siempre como texto."
                                      },
                                      "state": {
                                        "type": "string",
                                        "pattern": "^\\d{2}$",
                                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                                      },
                                      "city": {
                                        "type": "string",
                                        "pattern": "^\\d{2}$",
                                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                                      },
                                      "address1": {
                                        "type": "string"
                                      },
                                      "address2": {
                                        "type": "string"
                                      },
                                      "directory": {
                                        "nullable": true,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "enum": [
                                                "phone",
                                                "email",
                                                "cellphone"
                                              ]
                                            },
                                            "value": {
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "value"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "country",
                                      "state",
                                      "city",
                                      "address1",
                                      "address2",
                                      "directory"
                                    ]
                                  },
                                  "svFields": {
                                    "type": "object",
                                    "properties": {
                                      "nrc": {
                                        "type": "string"
                                      },
                                      "nit": {
                                        "type": "string",
                                        "pattern": "/^\\d{4}-\\d{6}-\\d{3}-\\d$/"
                                      },
                                      "dui": {
                                        "type": "string",
                                        "pattern": "/^\\d{8}-\\d$/"
                                      },
                                      "taxerType": {
                                        "type": "number"
                                      },
                                      "economicActivity": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "nrc",
                                      "nit",
                                      "dui",
                                      "taxerType",
                                      "economicActivity"
                                    ],
                                    "nullable": true
                                  },
                                  "id": {
                                    "type": "string"
                                  },
                                  "name": {
                                    "type": "string"
                                  },
                                  "name1": {
                                    "type": "string"
                                  },
                                  "name2": {
                                    "type": "string"
                                  },
                                  "name3": {
                                    "type": "string"
                                  },
                                  "lastname1": {
                                    "type": "string"
                                  },
                                  "lastname2": {
                                    "type": "string"
                                  },
                                  "lastname3": {
                                    "type": "string"
                                  },
                                  "shortName": {
                                    "type": "string"
                                  },
                                  "type": {
                                    "type": "number",
                                    "enum": [
                                      1,
                                      2,
                                      3
                                    ]
                                  },
                                  "personType": {
                                    "type": "number",
                                    "enum": [
                                      1,
                                      2,
                                      3
                                    ]
                                  },
                                  "personTypeNatural": {
                                    "type": "number",
                                    "enum": [
                                      1,
                                      2
                                    ]
                                  },
                                  "directory": {
                                    "nullable": true,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "enum": [
                                            "phone",
                                            "email",
                                            "cellphone"
                                          ]
                                        },
                                        "value": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ]
                                    }
                                  },
                                  "isRetentionAgent": {
                                    "type": "boolean",
                                    "description": "Agente de retención. Omitido: no cambia ningún valor almacenado. Presente: se guarda con la regla de clientes\n(solo una persona jurídica puede serlo; un gran contribuyente siempre lo es)."
                                  }
                                },
                                "required": [
                                  "branch",
                                  "svFields",
                                  "id",
                                  "name",
                                  "name1",
                                  "name2",
                                  "name3",
                                  "lastname1",
                                  "lastname2",
                                  "lastname3",
                                  "shortName",
                                  "type",
                                  "personType",
                                  "personTypeNatural",
                                  "directory"
                                ]
                              }
                            ]
                          },
                          "paymentCondition": {
                            "description": "UUID de Openbox Cloud del registro (referencia) u objeto completo.",
                            "oneOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
                                "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string"
                                  },
                                  "name": {
                                    "type": "string"
                                  },
                                  "cashPayment": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "id",
                                  "name",
                                  "cashPayment"
                                ]
                              }
                            ]
                          },
                          "invoicesSeller": {
                            "description": "UUID de Openbox Cloud del registro (referencia) u objeto completo.",
                            "oneOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
                                "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "zone": {
                                    "description": "UUID de Openbox Cloud del registro (referencia) u objeto completo.",
                                    "oneOf": [
                                      {
                                        "type": "string",
                                        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
                                        "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC."
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "type": "string"
                                          },
                                          "name": {
                                            "type": "string"
                                          }
                                        },
                                        "required": [
                                          "id",
                                          "name"
                                        ]
                                      }
                                    ]
                                  },
                                  "id": {
                                    "type": "string"
                                  },
                                  "name": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "zone",
                                  "id",
                                  "name"
                                ]
                              }
                            ]
                          },
                          "documentType": {
                            "type": "string",
                            "enum": [
                              "CCF",
                              "FCF",
                              "NC",
                              "FEX"
                            ]
                          },
                          "invoiceDate": {
                            "format": "date-time",
                            "type": "string"
                          },
                          "creditFor": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "customer",
                          "paymentCondition",
                          "invoicesSeller",
                          "documentType",
                          "invoiceDate",
                          "creditFor"
                        ]
                      },
                      "details": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "service": {
                              "nullable": true,
                              "description": "UUID de Openbox Cloud del registro (referencia) u objeto completo.",
                              "oneOf": [
                                {
                                  "type": "string",
                                  "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
                                  "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC."
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string"
                                    },
                                    "name": {
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "name"
                                  ],
                                  "nullable": true
                                }
                              ]
                            },
                            "product": {
                              "nullable": true,
                              "description": "UUID de Openbox Cloud del registro (referencia) u objeto completo.",
                              "oneOf": [
                                {
                                  "type": "string",
                                  "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
                                  "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC."
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string"
                                    },
                                    "name": {
                                      "type": "string"
                                    },
                                    "unit": {
                                      "type": "number",
                                      "enum": [
                                        1,
                                        2,
                                        6,
                                        9,
                                        10,
                                        13,
                                        15,
                                        18,
                                        20,
                                        22,
                                        23,
                                        24,
                                        26,
                                        30,
                                        32,
                                        33,
                                        34,
                                        36,
                                        37,
                                        38,
                                        39,
                                        40,
                                        42,
                                        43,
                                        44,
                                        45,
                                        46,
                                        47,
                                        49,
                                        50,
                                        51,
                                        52,
                                        53,
                                        54,
                                        55,
                                        56,
                                        57,
                                        58,
                                        59,
                                        99
                                      ]
                                    },
                                    "batch": {
                                      "type": "object",
                                      "properties": {
                                        "batchNumber": {
                                          "type": "string"
                                        },
                                        "expirationDate": {
                                          "format": "date-time",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "batchNumber",
                                        "expirationDate"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "name",
                                    "unit"
                                  ],
                                  "nullable": true
                                }
                              ]
                            },
                            "quantity": {
                              "type": "number",
                              "minimum": 0
                            },
                            "chargeDescription": {
                              "type": "string",
                              "maxLength": 1000
                            },
                            "incIva": {
                              "type": "boolean"
                            },
                            "price": {
                              "type": "number",
                              "minimum": 0
                            },
                            "unitPrice": {
                              "type": "number",
                              "minimum": 0
                            },
                            "ivaPrice": {
                              "type": "number",
                              "minimum": 0
                            },
                            "ventaPrice": {
                              "type": "number",
                              "minimum": 0
                            },
                            "totalNoSuj": {
                              "type": "number",
                              "minimum": 0
                            },
                            "totalExenta": {
                              "type": "number",
                              "minimum": 0
                            },
                            "totalGravada": {
                              "type": "number",
                              "minimum": 0
                            },
                            "totalIvaPrice": {
                              "type": "number",
                              "minimum": 0
                            },
                            "sellingType": {
                              "type": "number",
                              "enum": [
                                1,
                                2,
                                3
                              ]
                            }
                          },
                          "required": [
                            "service",
                            "product",
                            "quantity"
                          ]
                        }
                      },
                      "totals": {
                        "type": "object",
                        "properties": {
                          "totalNoSuj": {
                            "type": "number",
                            "minimum": 0
                          },
                          "totalExenta": {
                            "type": "number",
                            "minimum": 0
                          },
                          "totalGravada": {
                            "type": "number",
                            "minimum": 0
                          },
                          "subTotalVentas": {
                            "type": "number",
                            "minimum": 0
                          },
                          "descuNoSuj": {
                            "type": "number",
                            "minimum": 0
                          },
                          "descuExenta": {
                            "type": "number",
                            "minimum": 0
                          },
                          "descuGravada": {
                            "type": "number",
                            "minimum": 0
                          },
                          "subTotal": {
                            "type": "number",
                            "minimum": 0
                          },
                          "ivaRete1": {
                            "type": "number",
                            "minimum": 0
                          },
                          "reteRenta": {
                            "type": "number",
                            "minimum": 0
                          },
                          "montoTotalOperacion": {
                            "type": "number",
                            "minimum": 0
                          },
                          "totalIva": {
                            "type": "number",
                            "minimum": 0
                          },
                          "totalPagar": {
                            "type": "number",
                            "minimum": 0
                          }
                        },
                        "description": "Omitido: Openbox Cloud calcula los montos (modo calculado; toda línea por referencia)."
                      }
                    },
                    "required": [
                      "header",
                      "details"
                    ]
                  }
                },
                "required": [
                  "settings",
                  "data"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "haciendaResponse": {
                      "type": "object",
                      "properties": {
                        "ambiente": {
                          "type": "string",
                          "enum": [
                            "01",
                            "00"
                          ],
                          "description": "Ambiente del Ministerio de Hacienda: 01 producción, 00 pruebas."
                        },
                        "selloRecibido": {
                          "type": "string",
                          "nullable": true,
                          "description": "Sello del MH. `null` si el MH rechaza o falla el transporte."
                        },
                        "descripcionMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Mensaje del MH. `null` si el MH no lo devuelve."
                        },
                        "fhProcesamiento": {
                          "type": "string",
                          "nullable": true,
                          "description": "Fecha y hora de proceso del MH. `null` en el rechazo."
                        },
                        "codigoMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Código de mensaje del MH (opaco)."
                        },
                        "estado": {
                          "type": "string"
                        },
                        "observaciones": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "codigoGeneracion": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "ambiente",
                        "selloRecibido",
                        "descripcionMsg",
                        "fhProcesamiento",
                        "codigoMsg",
                        "estado",
                        "observaciones",
                        "codigoGeneracion"
                      ],
                      "nullable": true,
                      "description": "Respuesta del MH. `null` mientras el documento no se ha presentado."
                    },
                    "id": {
                      "type": "string"
                    },
                    "pdfURL": {
                      "type": "string"
                    },
                    "jsonURL": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "EMITIDA",
                        "PRESENTADA",
                        "ANULADA",
                        "CONTINGENCIA",
                        "PAGADA",
                        "RECIBIDA",
                        "IMPRESA",
                        "RESERVADA",
                        "CONVERTIDA"
                      ]
                    }
                  },
                  "required": [
                    "haciendaResponse",
                    "id",
                    "pdfURL",
                    "jsonURL",
                    "status"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato (validación); una referencia no existe en tu empresa (code REFERENCE_NOT_FOUND); faltan datos para el modo de la venta (code INSUFFICIENT_DATA_TO_CALCULATE); o un monto enviado no coincide al centavo con el que corresponde (`message` nombra el campo, lo enviado y el valor correcto). Estos cuatro tipos de 400 llegan antes de escribir nada y de llamar al MH.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe una venta con ese internalId en un estado que impide recrearla, o el id que enviaste ya existe (este último con code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Ventas"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Con referencias o con objetos; sin montos los calcula Openbox Cloud, con montos los verifica al centavo.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1InvoicesGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar ventas por internalId",
        "parameters": [
          {
            "name": "internalId",
            "required": true,
            "in": "query",
            "description": "Referencia externa del integrador (`settings.internalId` al emitir).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "haciendaResponse": {
                            "type": "object",
                            "properties": {
                              "ambiente": {
                                "type": "string",
                                "enum": [
                                  "01",
                                  "00"
                                ],
                                "description": "Ambiente del Ministerio de Hacienda: 01 producción, 00 pruebas."
                              },
                              "selloRecibido": {
                                "type": "string",
                                "nullable": true,
                                "description": "Sello del MH. `null` si el MH rechaza o falla el transporte."
                              },
                              "descripcionMsg": {
                                "type": "string",
                                "nullable": true,
                                "description": "Mensaje del MH. `null` si el MH no lo devuelve."
                              },
                              "fhProcesamiento": {
                                "type": "string",
                                "nullable": true,
                                "description": "Fecha y hora de proceso del MH. `null` en el rechazo."
                              },
                              "codigoMsg": {
                                "type": "string",
                                "nullable": true,
                                "description": "Código de mensaje del MH (opaco)."
                              },
                              "estado": {
                                "type": "string"
                              },
                              "observaciones": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "codigoGeneracion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "ambiente",
                              "selloRecibido",
                              "descripcionMsg",
                              "fhProcesamiento",
                              "codigoMsg",
                              "estado",
                              "observaciones",
                              "codigoGeneracion"
                            ],
                            "nullable": true,
                            "description": "Respuesta del MH. `null` mientras el documento no se ha presentado."
                          },
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string"
                          },
                          "documentType": {
                            "type": "string",
                            "enum": [
                              "CCF",
                              "FCF",
                              "NC",
                              "FEX"
                            ]
                          },
                          "createdAt": {
                            "format": "date-time",
                            "type": "string"
                          },
                          "pdfURL": {
                            "type": "string"
                          },
                          "jsonURL": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "EMITIDA",
                              "PRESENTADA",
                              "ANULADA",
                              "CONTINGENCIA",
                              "PAGADA",
                              "RECIBIDA",
                              "IMPRESA",
                              "RESERVADA",
                              "CONVERTIDA"
                            ]
                          }
                        },
                        "required": [
                          "haciendaResponse",
                          "id",
                          "internalId",
                          "documentType",
                          "createdAt",
                          "pdfURL",
                          "jsonURL",
                          "status"
                        ]
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Ventas"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Devuelve todas las coincidencias, de la más reciente a la más antigua.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/invoices/{id}": {
      "get": {
        "operationId": "partnersV1InvoicesGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar venta",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "haciendaResponse": {
                      "type": "object",
                      "properties": {
                        "ambiente": {
                          "type": "string",
                          "enum": [
                            "01",
                            "00"
                          ],
                          "description": "Ambiente del Ministerio de Hacienda: 01 producción, 00 pruebas."
                        },
                        "selloRecibido": {
                          "type": "string",
                          "nullable": true,
                          "description": "Sello del MH. `null` si el MH rechaza o falla el transporte."
                        },
                        "descripcionMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Mensaje del MH. `null` si el MH no lo devuelve."
                        },
                        "fhProcesamiento": {
                          "type": "string",
                          "nullable": true,
                          "description": "Fecha y hora de proceso del MH. `null` en el rechazo."
                        },
                        "codigoMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Código de mensaje del MH (opaco)."
                        },
                        "estado": {
                          "type": "string"
                        },
                        "observaciones": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "codigoGeneracion": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "ambiente",
                        "selloRecibido",
                        "descripcionMsg",
                        "fhProcesamiento",
                        "codigoMsg",
                        "estado",
                        "observaciones",
                        "codigoGeneracion"
                      ],
                      "nullable": true,
                      "description": "Respuesta del MH. `null` mientras el documento no se ha presentado."
                    },
                    "id": {
                      "type": "string"
                    },
                    "pdfURL": {
                      "type": "string"
                    },
                    "jsonURL": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "EMITIDA",
                        "PRESENTADA",
                        "ANULADA",
                        "CONTINGENCIA",
                        "PAGADA",
                        "RECIBIDA",
                        "IMPRESA",
                        "RESERVADA",
                        "CONVERTIDA"
                      ]
                    }
                  },
                  "required": [
                    "haciendaResponse",
                    "id",
                    "pdfURL",
                    "jsonURL",
                    "status"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato, o la venta no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Ventas"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/invoices/void/{id}": {
      "put": {
        "operationId": "partnersV1InvoicesVoidSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Anular venta",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "haciendaResponse": {
                      "type": "object",
                      "properties": {
                        "ambiente": {
                          "type": "string",
                          "enum": [
                            "01",
                            "00"
                          ],
                          "description": "Ambiente del Ministerio de Hacienda: 01 producción, 00 pruebas."
                        },
                        "selloRecibido": {
                          "type": "string",
                          "nullable": true,
                          "description": "Sello del MH. `null` si el MH rechaza o falla el transporte."
                        },
                        "descripcionMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Mensaje del MH. `null` si el MH no lo devuelve."
                        },
                        "fhProcesamiento": {
                          "type": "string",
                          "nullable": true,
                          "description": "Fecha y hora de proceso del MH. `null` en el rechazo."
                        },
                        "codigoMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Código de mensaje del MH (opaco)."
                        },
                        "estado": {
                          "type": "string"
                        },
                        "observaciones": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "codigoGeneracion": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "ambiente",
                        "selloRecibido",
                        "descripcionMsg",
                        "fhProcesamiento",
                        "codigoMsg",
                        "estado",
                        "observaciones",
                        "codigoGeneracion"
                      ],
                      "nullable": true,
                      "description": "Respuesta del MH. `null` mientras el documento no se ha presentado."
                    },
                    "id": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "EMITIDA",
                        "PRESENTADA",
                        "ANULADA",
                        "CONTINGENCIA",
                        "PAGADA",
                        "RECIBIDA",
                        "IMPRESA",
                        "RESERVADA",
                        "CONVERTIDA"
                      ]
                    }
                  },
                  "required": [
                    "haciendaResponse",
                    "id",
                    "message",
                    "status"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato, la venta no existe en tu empresa, o su estado no permite anularla (por ejemplo, ya anulada, pagada o en contingencia).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Facturación.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Ventas"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Invalida ante el Ministerio de Hacienda una venta ya procesada.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/purchases/payment-conditions": {
      "post": {
        "operationId": "partnersV1PurchasesPaymentConditionsCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear condición de pago de compra",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "UUID de Openbox Cloud propuesto por el integrador (8-4-4-4-12 por forma). Omitido: lo genera Openbox Cloud."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: sin internalId."
                  },
                  "name": {
                    "type": "string"
                  },
                  "cashPayment": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "name",
                  "cashPayment"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "cashPayment": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "cashPayment"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Compras.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe un registro activo con ese internalId en tu empresa, o el id que enviaste ya existe (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de compra"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Agrega un registro nuevo al catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1PurchasesPaymentConditionsGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Listar condiciones de pago de compra",
        "parameters": [
          {
            "name": "internalId",
            "required": false,
            "in": "query",
            "description": "Filtra por la referencia externa del integrador (coincidencia exacta, sensible a mayúsculas).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Página (desde 1). Por omisión 1.",
            "schema": {
              "minimum": 1,
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Registros por página (1 a 100). Por omisión 20.",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string",
                            "nullable": true
                          },
                          "name": {
                            "type": "string"
                          },
                          "cashPayment": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "internalId",
                          "name",
                          "cashPayment"
                        ]
                      }
                    },
                    "count": {
                      "type": "number"
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "data",
                    "count",
                    "page",
                    "limit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Compras.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de compra"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Con filtro opcional por tu internalId.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/purchases/payment-conditions/{id}": {
      "get": {
        "operationId": "partnersV1PurchasesPaymentConditionsGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar condición de pago de compra",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "cashPayment": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "cashPayment"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Compras.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La condición de pago de compra no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de compra"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "patch": {
        "operationId": "partnersV1PurchasesPaymentConditionsUpdateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Actualizar condición de pago de compra",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: la quita."
                  },
                  "name": {
                    "type": "string"
                  },
                  "cashPayment": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "cashPayment": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "cashPayment"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Compras.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La condición de pago de compra no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Otro registro activo de tu empresa ya usa ese internalId (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de compra"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Actualización parcial: solo cambian los campos que envíes.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "delete": {
        "operationId": "partnersV1PurchasesPaymentConditionsDeleteSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Eliminar condición de pago de compra",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "message"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Compras.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La condición de pago de compra no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Condiciones de pago de compra"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Quita el registro del catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/purchases": {
      "post": {
        "operationId": "partnersV1PurchasesCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear compra FSE",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "settings": {
                    "type": "object",
                    "properties": {
                      "notify": {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          "EMAIL"
                        ]
                      },
                      "internalId": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "notify"
                    ]
                  },
                  "data": {
                    "type": "object",
                    "properties": {
                      "header": {
                        "type": "object",
                        "properties": {
                          "provider": {
                            "description": "UUID de Openbox Cloud del registro (referencia) u objeto completo.",
                            "oneOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
                                "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "branch": {
                                    "type": "object",
                                    "properties": {
                                      "country": {
                                        "type": "string",
                                        "pattern": "^(\\d{4}|[A-Za-z]{2})$",
                                        "description": "SVCode de 4 dígitos o código ISO 3166-1 alfa-2 (ej. \"PA\"), siempre como texto."
                                      },
                                      "state": {
                                        "type": "string",
                                        "pattern": "^\\d{2}$",
                                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                                      },
                                      "city": {
                                        "type": "string",
                                        "pattern": "^\\d{2}$",
                                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                                      },
                                      "address1": {
                                        "type": "string"
                                      },
                                      "address2": {
                                        "type": "string"
                                      },
                                      "directory": {
                                        "nullable": true,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "enum": [
                                                "phone",
                                                "email",
                                                "cellphone"
                                              ]
                                            },
                                            "value": {
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "value"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "country",
                                      "state",
                                      "city",
                                      "address1",
                                      "address2",
                                      "directory"
                                    ]
                                  },
                                  "svFields": {
                                    "type": "object",
                                    "properties": {
                                      "nrc": {
                                        "type": "string"
                                      },
                                      "nit": {
                                        "type": "string",
                                        "pattern": "/^\\d{4}-\\d{6}-\\d{3}-\\d$/"
                                      },
                                      "dui": {
                                        "type": "string",
                                        "pattern": "/^\\d{8}-\\d$/"
                                      },
                                      "taxerType": {
                                        "type": "number"
                                      },
                                      "economicActivity": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "nrc",
                                      "nit",
                                      "dui",
                                      "taxerType",
                                      "economicActivity"
                                    ],
                                    "nullable": true
                                  },
                                  "id": {
                                    "type": "string"
                                  },
                                  "name": {
                                    "type": "string"
                                  },
                                  "name1": {
                                    "type": "string"
                                  },
                                  "name2": {
                                    "type": "string"
                                  },
                                  "name3": {
                                    "type": "string"
                                  },
                                  "lastname1": {
                                    "type": "string"
                                  },
                                  "lastname2": {
                                    "type": "string"
                                  },
                                  "lastname3": {
                                    "type": "string"
                                  },
                                  "shortName": {
                                    "type": "string"
                                  },
                                  "type": {
                                    "type": "number",
                                    "enum": [
                                      1,
                                      2,
                                      3
                                    ]
                                  },
                                  "personType": {
                                    "type": "number",
                                    "enum": [
                                      1,
                                      2,
                                      3
                                    ]
                                  },
                                  "personTypeNatural": {
                                    "type": "number",
                                    "enum": [
                                      1,
                                      2
                                    ]
                                  },
                                  "directory": {
                                    "nullable": true,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "enum": [
                                            "phone",
                                            "email",
                                            "cellphone"
                                          ]
                                        },
                                        "value": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ]
                                    }
                                  }
                                },
                                "required": [
                                  "branch",
                                  "svFields",
                                  "id",
                                  "name",
                                  "name1",
                                  "name2",
                                  "name3",
                                  "lastname1",
                                  "lastname2",
                                  "lastname3",
                                  "shortName",
                                  "type",
                                  "personType",
                                  "personTypeNatural",
                                  "directory"
                                ]
                              }
                            ]
                          },
                          "paymentCondition": {
                            "description": "UUID de Openbox Cloud del registro (referencia) u objeto completo.",
                            "oneOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
                                "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string"
                                  },
                                  "name": {
                                    "type": "string"
                                  },
                                  "cashPayment": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "id",
                                  "name",
                                  "cashPayment"
                                ]
                              }
                            ]
                          },
                          "documentType": {
                            "type": "string",
                            "enum": [
                              "FSE"
                            ]
                          },
                          "purchaseDate": {
                            "format": "date-time",
                            "type": "string"
                          }
                        },
                        "required": [
                          "provider",
                          "paymentCondition",
                          "documentType",
                          "purchaseDate"
                        ]
                      },
                      "details": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "service": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "name"
                              ]
                            },
                            "quantity": {
                              "type": "number",
                              "minimum": 1
                            },
                            "unitPrice": {
                              "type": "number",
                              "minimum": 0
                            },
                            "montoDescu": {
                              "type": "number",
                              "minimum": 0
                            },
                            "compra": {
                              "type": "number",
                              "minimum": 0
                            },
                            "description": {
                              "type": "string",
                              "maxLength": 1000
                            },
                            "purchaseType": {
                              "type": "number",
                              "enum": [
                                1,
                                2,
                                3
                              ]
                            }
                          },
                          "required": [
                            "service",
                            "quantity",
                            "unitPrice",
                            "montoDescu",
                            "compra",
                            "description",
                            "purchaseType"
                          ]
                        }
                      },
                      "totals": {
                        "type": "object",
                        "properties": {
                          "totalCompra": {
                            "type": "number",
                            "minimum": 0
                          },
                          "descu": {
                            "type": "number",
                            "minimum": 0
                          },
                          "totalDescu": {
                            "type": "number",
                            "minimum": 0
                          },
                          "subTotal": {
                            "type": "number",
                            "minimum": 0
                          },
                          "ivaRetenido": {
                            "type": "number",
                            "minimum": 0
                          },
                          "reteRenta": {
                            "type": "number",
                            "minimum": 0
                          },
                          "totalPagar": {
                            "type": "number",
                            "minimum": 0
                          }
                        },
                        "required": [
                          "totalCompra",
                          "descu",
                          "totalDescu",
                          "subTotal",
                          "ivaRetenido",
                          "reteRenta",
                          "totalPagar"
                        ]
                      }
                    },
                    "required": [
                      "header",
                      "details",
                      "totals"
                    ]
                  }
                },
                "required": [
                  "settings",
                  "data"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "haciendaResponse": {
                      "type": "object",
                      "properties": {
                        "ambiente": {
                          "type": "string",
                          "enum": [
                            "01",
                            "00"
                          ],
                          "description": "Ambiente del Ministerio de Hacienda: 01 producción, 00 pruebas."
                        },
                        "selloRecibido": {
                          "type": "string",
                          "nullable": true,
                          "description": "Sello del MH. `null` si el MH rechaza o falla el transporte."
                        },
                        "descripcionMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Mensaje del MH. `null` si el MH no lo devuelve."
                        },
                        "fhProcesamiento": {
                          "type": "string",
                          "nullable": true,
                          "description": "Fecha y hora de proceso del MH. `null` en el rechazo."
                        },
                        "codigoMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Código de mensaje del MH (opaco)."
                        },
                        "estado": {
                          "type": "string"
                        },
                        "observaciones": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "codigoGeneracion": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "ambiente",
                        "selloRecibido",
                        "descripcionMsg",
                        "fhProcesamiento",
                        "codigoMsg",
                        "estado",
                        "observaciones",
                        "codigoGeneracion"
                      ],
                      "nullable": true,
                      "description": "Respuesta del MH. `null` mientras el documento no se ha presentado."
                    },
                    "id": {
                      "type": "string"
                    },
                    "pdfURL": {
                      "type": "string"
                    },
                    "jsonURL": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "EMITIDA",
                        "PRESENTADA",
                        "ANULADA",
                        "CONTINGENCIA",
                        "PAGADA",
                        "RECIBIDA",
                        "IMPRESA",
                        "RESERVADA",
                        "CONVERTIDA"
                      ]
                    }
                  },
                  "required": [
                    "haciendaResponse",
                    "id",
                    "pdfURL",
                    "jsonURL",
                    "status"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato (validación), o el proveedor o la condición de pago que citas por referencia no existe en tu empresa o fue eliminado, o lo envías como objeto con el id de uno que tu empresa eliminó (code REFERENCE_NOT_FOUND). Estos 400 llegan antes de escribir nada y de llamar al MH. Si además el documento no pasa la validación electrónica, el 400 trae el motivo en `message` y puede llegar después de crear o actualizar el proveedor o la condición de pago que enviaste como objeto.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Compras.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe una compra con ese internalId en un estado que impide recrearla, o el id que enviaste ya existe (este último con code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Compras"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Factura de sujeto excluido. El proveedor y la condición de pago van por referencia (su UUID de Openbox Cloud) o como objeto.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1PurchasesGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar compras por internalId",
        "parameters": [
          {
            "name": "internalId",
            "required": true,
            "in": "query",
            "description": "Referencia externa del integrador (`settings.internalId` al emitir).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "haciendaResponse": {
                            "type": "object",
                            "properties": {
                              "ambiente": {
                                "type": "string",
                                "enum": [
                                  "01",
                                  "00"
                                ],
                                "description": "Ambiente del Ministerio de Hacienda: 01 producción, 00 pruebas."
                              },
                              "selloRecibido": {
                                "type": "string",
                                "nullable": true,
                                "description": "Sello del MH. `null` si el MH rechaza o falla el transporte."
                              },
                              "descripcionMsg": {
                                "type": "string",
                                "nullable": true,
                                "description": "Mensaje del MH. `null` si el MH no lo devuelve."
                              },
                              "fhProcesamiento": {
                                "type": "string",
                                "nullable": true,
                                "description": "Fecha y hora de proceso del MH. `null` en el rechazo."
                              },
                              "codigoMsg": {
                                "type": "string",
                                "nullable": true,
                                "description": "Código de mensaje del MH (opaco)."
                              },
                              "estado": {
                                "type": "string"
                              },
                              "observaciones": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "codigoGeneracion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "ambiente",
                              "selloRecibido",
                              "descripcionMsg",
                              "fhProcesamiento",
                              "codigoMsg",
                              "estado",
                              "observaciones",
                              "codigoGeneracion"
                            ],
                            "nullable": true,
                            "description": "Respuesta del MH. `null` mientras el documento no se ha presentado."
                          },
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string"
                          },
                          "documentType": {
                            "type": "string",
                            "enum": [
                              "FSE"
                            ]
                          },
                          "createdAt": {
                            "format": "date-time",
                            "type": "string"
                          },
                          "pdfURL": {
                            "type": "string"
                          },
                          "jsonURL": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "EMITIDA",
                              "PRESENTADA",
                              "ANULADA",
                              "CONTINGENCIA",
                              "PAGADA",
                              "RECIBIDA",
                              "IMPRESA",
                              "RESERVADA",
                              "CONVERTIDA"
                            ]
                          }
                        },
                        "required": [
                          "haciendaResponse",
                          "id",
                          "internalId",
                          "documentType",
                          "createdAt",
                          "pdfURL",
                          "jsonURL",
                          "status"
                        ]
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Compras.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Compras"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Devuelve todas las coincidencias, de la más reciente a la más antigua.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/purchases/{id}": {
      "get": {
        "operationId": "partnersV1PurchasesGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar compra",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "haciendaResponse": {
                      "type": "object",
                      "properties": {
                        "ambiente": {
                          "type": "string",
                          "enum": [
                            "01",
                            "00"
                          ],
                          "description": "Ambiente del Ministerio de Hacienda: 01 producción, 00 pruebas."
                        },
                        "selloRecibido": {
                          "type": "string",
                          "nullable": true,
                          "description": "Sello del MH. `null` si el MH rechaza o falla el transporte."
                        },
                        "descripcionMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Mensaje del MH. `null` si el MH no lo devuelve."
                        },
                        "fhProcesamiento": {
                          "type": "string",
                          "nullable": true,
                          "description": "Fecha y hora de proceso del MH. `null` en el rechazo."
                        },
                        "codigoMsg": {
                          "type": "string",
                          "nullable": true,
                          "description": "Código de mensaje del MH (opaco)."
                        },
                        "estado": {
                          "type": "string"
                        },
                        "observaciones": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "codigoGeneracion": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "ambiente",
                        "selloRecibido",
                        "descripcionMsg",
                        "fhProcesamiento",
                        "codigoMsg",
                        "estado",
                        "observaciones",
                        "codigoGeneracion"
                      ],
                      "nullable": true,
                      "description": "Respuesta del MH. `null` mientras el documento no se ha presentado."
                    },
                    "id": {
                      "type": "string"
                    },
                    "pdfURL": {
                      "type": "string"
                    },
                    "jsonURL": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "EMITIDA",
                        "PRESENTADA",
                        "ANULADA",
                        "CONTINGENCIA",
                        "PAGADA",
                        "RECIBIDA",
                        "IMPRESA",
                        "RESERVADA",
                        "CONVERTIDA"
                      ]
                    }
                  },
                  "required": [
                    "haciendaResponse",
                    "id",
                    "pdfURL",
                    "jsonURL",
                    "status"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Compras.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La compra no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Compras"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/customers": {
      "post": {
        "operationId": "partnersV1CustomersCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear cliente",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "branch": {
                    "type": "object",
                    "properties": {
                      "country": {
                        "type": "string",
                        "pattern": "^(\\d{4}|[A-Za-z]{2})$",
                        "description": "SVCode de 4 dígitos o código ISO 3166-1 alfa-2 (ej. \"PA\"), siempre como texto."
                      },
                      "state": {
                        "type": "string",
                        "pattern": "^\\d{2}$",
                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                      },
                      "city": {
                        "type": "string",
                        "pattern": "^\\d{2}$",
                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                      },
                      "directory": {
                        "nullable": true,
                        "description": "Contactos de la sucursal: requeridos (1 a 3) para persona jurídica; `null` para natural o extranjera.",
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "phone",
                                "email",
                                "cellphone"
                              ]
                            },
                            "value": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "type",
                            "value"
                          ]
                        }
                      },
                      "address1": {
                        "type": "string"
                      },
                      "address2": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "country",
                      "state",
                      "city",
                      "directory",
                      "address1",
                      "address2"
                    ]
                  },
                  "directory": {
                    "nullable": true,
                    "description": "Contactos: requeridos (1 a 3) para persona natural o extranjera; `null` para jurídica.",
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "phone",
                            "email",
                            "cellphone"
                          ]
                        },
                        "value": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "value"
                      ]
                    }
                  },
                  "svFields": {
                    "type": "object",
                    "properties": {
                      "nrc": {
                        "type": "string"
                      },
                      "nit": {
                        "type": "string",
                        "pattern": "/^\\d{4}-\\d{6}-\\d{3}-\\d$/"
                      },
                      "dui": {
                        "type": "string",
                        "pattern": "/^\\d{8}-\\d$/"
                      },
                      "taxerType": {
                        "type": "number"
                      },
                      "economicActivity": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "nrc",
                      "nit",
                      "dui",
                      "taxerType",
                      "economicActivity"
                    ],
                    "nullable": true,
                    "description": "Datos fiscales: requeridos para persona jurídica y natural que declara IVA; `null` para extranjera o natural que no declara IVA."
                  },
                  "id": {
                    "type": "string",
                    "description": "UUID de Openbox Cloud propuesto por el integrador (8-4-4-4-12 por forma). Omitido: lo genera Openbox Cloud."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: sin internalId."
                  },
                  "name": {
                    "type": "string",
                    "nullable": true
                  },
                  "name1": {
                    "type": "string",
                    "nullable": true
                  },
                  "name2": {
                    "type": "string",
                    "nullable": true
                  },
                  "name3": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname1": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname2": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname3": {
                    "type": "string",
                    "nullable": true
                  },
                  "shortName": {
                    "type": "string",
                    "description": "Nombre comercial: requerido y no vacío para todo tipo de persona, como en la web (spec 079, criterio 8)."
                  },
                  "type": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "personType": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "personTypeNatural": {
                    "type": "number",
                    "nullable": true,
                    "enum": [
                      1,
                      2
                    ]
                  },
                  "isRetentionAgent": {
                    "type": "boolean",
                    "description": "Agente de retención. Omitido al crear: `false`; en la actualización, omitido conserva el valor."
                  }
                },
                "required": [
                  "branch",
                  "directory",
                  "svFields",
                  "name",
                  "name1",
                  "name2",
                  "name3",
                  "lastname1",
                  "lastname2",
                  "lastname3",
                  "shortName",
                  "type",
                  "personType",
                  "personTypeNatural"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "branch": {
                      "type": "object",
                      "properties": {
                        "country": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "state": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "city": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "address1": {
                          "type": "string"
                        },
                        "address2": {
                          "type": "string",
                          "nullable": true
                        },
                        "directory": {
                          "nullable": true,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "phone",
                                  "email",
                                  "cellphone"
                                ]
                              },
                              "value": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "value"
                            ]
                          }
                        }
                      },
                      "required": [
                        "country",
                        "state",
                        "city",
                        "address1",
                        "address2",
                        "directory"
                      ],
                      "nullable": true,
                      "description": "Sucursal principal (la más antigua). `null` solo en un cliente de la web sin sucursal."
                    },
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string",
                      "nullable": true
                    },
                    "name1": {
                      "type": "string",
                      "nullable": true
                    },
                    "name2": {
                      "type": "string",
                      "nullable": true
                    },
                    "name3": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname1": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname2": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname3": {
                      "type": "string",
                      "nullable": true
                    },
                    "shortName": {
                      "type": "string"
                    },
                    "type": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personTypeNatural": {
                      "nullable": true,
                      "enum": [
                        1,
                        2
                      ],
                      "type": "number"
                    },
                    "directory": {
                      "nullable": true,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "phone",
                              "email",
                              "cellphone"
                            ]
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ]
                      }
                    },
                    "svFields": {
                      "type": "object",
                      "properties": {
                        "nrc": {
                          "type": "string",
                          "nullable": true
                        },
                        "nit": {
                          "type": "string",
                          "nullable": true
                        },
                        "dui": {
                          "type": "string",
                          "nullable": true
                        },
                        "taxerType": {
                          "type": "number",
                          "nullable": true,
                          "enum": [
                            1,
                            2,
                            3
                          ]
                        },
                        "economicActivity": {
                          "type": "string",
                          "nullable": true
                        }
                      },
                      "required": [
                        "nrc",
                        "nit",
                        "dui",
                        "taxerType",
                        "economicActivity"
                      ],
                      "nullable": true
                    },
                    "isRetentionAgent": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "branch",
                    "id",
                    "internalId",
                    "name",
                    "name1",
                    "name2",
                    "name3",
                    "lastname1",
                    "lastname2",
                    "lastname3",
                    "shortName",
                    "type",
                    "personType",
                    "personTypeNatural",
                    "directory",
                    "svFields",
                    "isRetentionAgent"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Clientes.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe un registro activo con ese internalId en tu empresa, o el id que enviaste ya existe (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Clientes"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Agrega un registro nuevo al catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1CustomersGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Listar clientes",
        "parameters": [
          {
            "name": "internalId",
            "required": false,
            "in": "query",
            "description": "Filtra por la referencia externa del integrador (coincidencia exacta, sensible a mayúsculas).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Página (desde 1). Por omisión 1.",
            "schema": {
              "minimum": 1,
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Registros por página (1 a 100). Por omisión 20.",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "branch": {
                            "type": "object",
                            "properties": {
                              "country": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "number",
                                    "description": "Id interno de Openbox Cloud."
                                  },
                                  "code": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                                  },
                                  "name": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "code",
                                  "name"
                                ],
                                "nullable": true
                              },
                              "state": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "number",
                                    "description": "Id interno de Openbox Cloud."
                                  },
                                  "code": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                                  },
                                  "name": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "code",
                                  "name"
                                ],
                                "nullable": true
                              },
                              "city": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "number",
                                    "description": "Id interno de Openbox Cloud."
                                  },
                                  "code": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                                  },
                                  "name": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "code",
                                  "name"
                                ],
                                "nullable": true
                              },
                              "address1": {
                                "type": "string"
                              },
                              "address2": {
                                "type": "string",
                                "nullable": true
                              },
                              "directory": {
                                "nullable": true,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "enum": [
                                        "phone",
                                        "email",
                                        "cellphone"
                                      ]
                                    },
                                    "value": {
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ]
                                }
                              }
                            },
                            "required": [
                              "country",
                              "state",
                              "city",
                              "address1",
                              "address2",
                              "directory"
                            ],
                            "nullable": true,
                            "description": "Sucursal principal (la más antigua). `null` solo en un cliente de la web sin sucursal."
                          },
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string",
                            "nullable": true
                          },
                          "name": {
                            "type": "string",
                            "nullable": true
                          },
                          "name1": {
                            "type": "string",
                            "nullable": true
                          },
                          "name2": {
                            "type": "string",
                            "nullable": true
                          },
                          "name3": {
                            "type": "string",
                            "nullable": true
                          },
                          "lastname1": {
                            "type": "string",
                            "nullable": true
                          },
                          "lastname2": {
                            "type": "string",
                            "nullable": true
                          },
                          "lastname3": {
                            "type": "string",
                            "nullable": true
                          },
                          "shortName": {
                            "type": "string"
                          },
                          "type": {
                            "enum": [
                              1,
                              2,
                              3
                            ],
                            "type": "number"
                          },
                          "personType": {
                            "enum": [
                              1,
                              2,
                              3
                            ],
                            "type": "number"
                          },
                          "personTypeNatural": {
                            "nullable": true,
                            "enum": [
                              1,
                              2
                            ],
                            "type": "number"
                          },
                          "directory": {
                            "nullable": true,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "phone",
                                    "email",
                                    "cellphone"
                                  ]
                                },
                                "value": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ]
                            }
                          },
                          "svFields": {
                            "type": "object",
                            "properties": {
                              "nrc": {
                                "type": "string",
                                "nullable": true
                              },
                              "nit": {
                                "type": "string",
                                "nullable": true
                              },
                              "dui": {
                                "type": "string",
                                "nullable": true
                              },
                              "taxerType": {
                                "type": "number",
                                "nullable": true,
                                "enum": [
                                  1,
                                  2,
                                  3
                                ]
                              },
                              "economicActivity": {
                                "type": "string",
                                "nullable": true
                              }
                            },
                            "required": [
                              "nrc",
                              "nit",
                              "dui",
                              "taxerType",
                              "economicActivity"
                            ],
                            "nullable": true
                          },
                          "isRetentionAgent": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "branch",
                          "id",
                          "internalId",
                          "name",
                          "name1",
                          "name2",
                          "name3",
                          "lastname1",
                          "lastname2",
                          "lastname3",
                          "shortName",
                          "type",
                          "personType",
                          "personTypeNatural",
                          "directory",
                          "svFields",
                          "isRetentionAgent"
                        ]
                      }
                    },
                    "count": {
                      "type": "number"
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "data",
                    "count",
                    "page",
                    "limit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Clientes.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Clientes"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Con filtro opcional por tu internalId.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/customers/{id}": {
      "get": {
        "operationId": "partnersV1CustomersGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar cliente",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "branch": {
                      "type": "object",
                      "properties": {
                        "country": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "state": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "city": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "address1": {
                          "type": "string"
                        },
                        "address2": {
                          "type": "string",
                          "nullable": true
                        },
                        "directory": {
                          "nullable": true,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "phone",
                                  "email",
                                  "cellphone"
                                ]
                              },
                              "value": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "value"
                            ]
                          }
                        }
                      },
                      "required": [
                        "country",
                        "state",
                        "city",
                        "address1",
                        "address2",
                        "directory"
                      ],
                      "nullable": true,
                      "description": "Sucursal principal (la más antigua). `null` solo en un cliente de la web sin sucursal."
                    },
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string",
                      "nullable": true
                    },
                    "name1": {
                      "type": "string",
                      "nullable": true
                    },
                    "name2": {
                      "type": "string",
                      "nullable": true
                    },
                    "name3": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname1": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname2": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname3": {
                      "type": "string",
                      "nullable": true
                    },
                    "shortName": {
                      "type": "string"
                    },
                    "type": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personTypeNatural": {
                      "nullable": true,
                      "enum": [
                        1,
                        2
                      ],
                      "type": "number"
                    },
                    "directory": {
                      "nullable": true,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "phone",
                              "email",
                              "cellphone"
                            ]
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ]
                      }
                    },
                    "svFields": {
                      "type": "object",
                      "properties": {
                        "nrc": {
                          "type": "string",
                          "nullable": true
                        },
                        "nit": {
                          "type": "string",
                          "nullable": true
                        },
                        "dui": {
                          "type": "string",
                          "nullable": true
                        },
                        "taxerType": {
                          "type": "number",
                          "nullable": true,
                          "enum": [
                            1,
                            2,
                            3
                          ]
                        },
                        "economicActivity": {
                          "type": "string",
                          "nullable": true
                        }
                      },
                      "required": [
                        "nrc",
                        "nit",
                        "dui",
                        "taxerType",
                        "economicActivity"
                      ],
                      "nullable": true
                    },
                    "isRetentionAgent": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "branch",
                    "id",
                    "internalId",
                    "name",
                    "name1",
                    "name2",
                    "name3",
                    "lastname1",
                    "lastname2",
                    "lastname3",
                    "shortName",
                    "type",
                    "personType",
                    "personTypeNatural",
                    "directory",
                    "svFields",
                    "isRetentionAgent"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Clientes.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El cliente no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Clientes"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "patch": {
        "operationId": "partnersV1CustomersUpdateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Actualizar cliente",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "branch": {
                    "type": "object",
                    "properties": {
                      "country": {
                        "type": "string",
                        "pattern": "^(\\d{4}|[A-Za-z]{2})$",
                        "description": "SVCode de 4 dígitos o código ISO 3166-1 alfa-2 (ej. \"PA\"), siempre como texto."
                      },
                      "state": {
                        "type": "string",
                        "pattern": "^\\d{2}$",
                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                      },
                      "city": {
                        "type": "string",
                        "pattern": "^\\d{2}$",
                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                      },
                      "directory": {
                        "nullable": true,
                        "description": "Reemplaza los contactos de la sucursal enteros. `null`: sin contactos (si la regla lo admite).",
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "phone",
                                "email",
                                "cellphone"
                              ]
                            },
                            "value": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "type",
                            "value"
                          ]
                        }
                      },
                      "address1": {
                        "type": "string"
                      },
                      "address2": {
                        "type": "string",
                        "nullable": true
                      }
                    },
                    "description": "Sucursal principal: se combina campo a campo con la guardada."
                  },
                  "directory": {
                    "nullable": true,
                    "description": "Reemplaza los contactos enteros. `null`: sin contactos (si la regla lo admite).",
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "phone",
                            "email",
                            "cellphone"
                          ]
                        },
                        "value": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "value"
                      ]
                    }
                  },
                  "svFields": {
                    "type": "object",
                    "properties": {
                      "nrc": {
                        "type": "string",
                        "nullable": true
                      },
                      "nit": {
                        "type": "string",
                        "nullable": true,
                        "pattern": "/^\\d{4}-\\d{6}-\\d{3}-\\d$/"
                      },
                      "dui": {
                        "type": "string",
                        "nullable": true,
                        "pattern": "/^\\d{8}-\\d$/"
                      },
                      "taxerType": {
                        "type": "number",
                        "nullable": true
                      },
                      "economicActivity": {
                        "type": "string",
                        "nullable": true
                      }
                    },
                    "nullable": true,
                    "description": "Datos fiscales: se combinan campo a campo; `null` los limpia todos (si la regla lo admite)."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: la quita."
                  },
                  "name": {
                    "type": "string",
                    "nullable": true
                  },
                  "name1": {
                    "type": "string",
                    "nullable": true
                  },
                  "name2": {
                    "type": "string",
                    "nullable": true
                  },
                  "name3": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname1": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname2": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname3": {
                    "type": "string",
                    "nullable": true
                  },
                  "shortName": {
                    "type": "string",
                    "description": "Omitido conserva; `null` o vacío da 400 (requerido, como en la web)."
                  },
                  "type": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "personType": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "personTypeNatural": {
                    "type": "number",
                    "nullable": true,
                    "enum": [
                      1,
                      2
                    ]
                  },
                  "isRetentionAgent": {
                    "type": "boolean",
                    "description": "Agente de retención. Omitido: conserva el valor (salvo la regla de la web, hld §8.4)."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "branch": {
                      "type": "object",
                      "properties": {
                        "country": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "state": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "city": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "address1": {
                          "type": "string"
                        },
                        "address2": {
                          "type": "string",
                          "nullable": true
                        },
                        "directory": {
                          "nullable": true,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "phone",
                                  "email",
                                  "cellphone"
                                ]
                              },
                              "value": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "value"
                            ]
                          }
                        }
                      },
                      "required": [
                        "country",
                        "state",
                        "city",
                        "address1",
                        "address2",
                        "directory"
                      ],
                      "nullable": true,
                      "description": "Sucursal principal (la más antigua). `null` solo en un cliente de la web sin sucursal."
                    },
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string",
                      "nullable": true
                    },
                    "name1": {
                      "type": "string",
                      "nullable": true
                    },
                    "name2": {
                      "type": "string",
                      "nullable": true
                    },
                    "name3": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname1": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname2": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname3": {
                      "type": "string",
                      "nullable": true
                    },
                    "shortName": {
                      "type": "string"
                    },
                    "type": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personTypeNatural": {
                      "nullable": true,
                      "enum": [
                        1,
                        2
                      ],
                      "type": "number"
                    },
                    "directory": {
                      "nullable": true,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "phone",
                              "email",
                              "cellphone"
                            ]
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ]
                      }
                    },
                    "svFields": {
                      "type": "object",
                      "properties": {
                        "nrc": {
                          "type": "string",
                          "nullable": true
                        },
                        "nit": {
                          "type": "string",
                          "nullable": true
                        },
                        "dui": {
                          "type": "string",
                          "nullable": true
                        },
                        "taxerType": {
                          "type": "number",
                          "nullable": true,
                          "enum": [
                            1,
                            2,
                            3
                          ]
                        },
                        "economicActivity": {
                          "type": "string",
                          "nullable": true
                        }
                      },
                      "required": [
                        "nrc",
                        "nit",
                        "dui",
                        "taxerType",
                        "economicActivity"
                      ],
                      "nullable": true
                    },
                    "isRetentionAgent": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "branch",
                    "id",
                    "internalId",
                    "name",
                    "name1",
                    "name2",
                    "name3",
                    "lastname1",
                    "lastname2",
                    "lastname3",
                    "shortName",
                    "type",
                    "personType",
                    "personTypeNatural",
                    "directory",
                    "svFields",
                    "isRetentionAgent"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Clientes.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El cliente no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Otro registro activo de tu empresa ya usa ese internalId (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Clientes"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Actualización parcial: solo cambian los campos que envíes.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "delete": {
        "operationId": "partnersV1CustomersDeleteSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Eliminar cliente",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "message"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Clientes.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El cliente no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Clientes"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Quita el registro del catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/providers": {
      "post": {
        "operationId": "partnersV1ProvidersCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear proveedor",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "branch": {
                    "type": "object",
                    "properties": {
                      "country": {
                        "type": "string",
                        "pattern": "^(\\d{4}|[A-Za-z]{2})$",
                        "description": "SVCode de 4 dígitos o código ISO 3166-1 alfa-2 (ej. \"PA\"), siempre como texto."
                      },
                      "state": {
                        "type": "string",
                        "pattern": "^\\d{2}$",
                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                      },
                      "city": {
                        "type": "string",
                        "pattern": "^\\d{2}$",
                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                      },
                      "directory": {
                        "nullable": true,
                        "description": "Contactos de la sucursal: requeridos (1 a 3) para persona jurídica; `null` para natural o extranjera.",
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "phone",
                                "email",
                                "cellphone"
                              ]
                            },
                            "value": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "type",
                            "value"
                          ]
                        }
                      },
                      "address1": {
                        "type": "string"
                      },
                      "address2": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "country",
                      "state",
                      "city",
                      "directory",
                      "address1",
                      "address2"
                    ]
                  },
                  "directory": {
                    "nullable": true,
                    "description": "Contactos: requeridos (1 a 3) para persona natural o extranjera; `null` para jurídica.",
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "phone",
                            "email",
                            "cellphone"
                          ]
                        },
                        "value": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "value"
                      ]
                    }
                  },
                  "svFields": {
                    "type": "object",
                    "properties": {
                      "nrc": {
                        "type": "string"
                      },
                      "nit": {
                        "type": "string",
                        "pattern": "/^\\d{4}-\\d{6}-\\d{3}-\\d$/"
                      },
                      "dui": {
                        "type": "string",
                        "pattern": "/^\\d{8}-\\d$/"
                      },
                      "taxerType": {
                        "type": "number"
                      },
                      "economicActivity": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "nrc",
                      "nit",
                      "dui",
                      "taxerType",
                      "economicActivity"
                    ],
                    "nullable": true,
                    "description": "Datos fiscales: requeridos para persona jurídica y natural que declara IVA; `null` para extranjera o natural que no declara IVA."
                  },
                  "id": {
                    "type": "string",
                    "description": "UUID de Openbox Cloud propuesto por el integrador (8-4-4-4-12 por forma). Omitido: lo genera Openbox Cloud."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: sin internalId."
                  },
                  "name": {
                    "type": "string",
                    "nullable": true
                  },
                  "name1": {
                    "type": "string",
                    "nullable": true
                  },
                  "name2": {
                    "type": "string",
                    "nullable": true
                  },
                  "name3": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname1": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname2": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname3": {
                    "type": "string",
                    "nullable": true
                  },
                  "shortName": {
                    "type": "string",
                    "description": "Nombre comercial: requerido y no vacío para todo tipo de persona, como en la web (spec 079, criterio 8)."
                  },
                  "type": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "personType": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "personTypeNatural": {
                    "type": "number",
                    "nullable": true,
                    "enum": [
                      1,
                      2
                    ]
                  }
                },
                "required": [
                  "branch",
                  "directory",
                  "svFields",
                  "name",
                  "name1",
                  "name2",
                  "name3",
                  "lastname1",
                  "lastname2",
                  "lastname3",
                  "shortName",
                  "type",
                  "personType",
                  "personTypeNatural"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "branch": {
                      "type": "object",
                      "properties": {
                        "country": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "state": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "city": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "address1": {
                          "type": "string"
                        },
                        "address2": {
                          "type": "string",
                          "nullable": true
                        },
                        "directory": {
                          "nullable": true,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "phone",
                                  "email",
                                  "cellphone"
                                ]
                              },
                              "value": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "value"
                            ]
                          }
                        }
                      },
                      "required": [
                        "country",
                        "state",
                        "city",
                        "address1",
                        "address2",
                        "directory"
                      ],
                      "nullable": true,
                      "description": "Sucursal principal (la más antigua). `null` solo en un proveedor de la web sin sucursal."
                    },
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string",
                      "nullable": true
                    },
                    "name1": {
                      "type": "string",
                      "nullable": true
                    },
                    "name2": {
                      "type": "string",
                      "nullable": true
                    },
                    "name3": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname1": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname2": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname3": {
                      "type": "string",
                      "nullable": true
                    },
                    "shortName": {
                      "type": "string"
                    },
                    "type": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personTypeNatural": {
                      "nullable": true,
                      "enum": [
                        1,
                        2
                      ],
                      "type": "number"
                    },
                    "directory": {
                      "nullable": true,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "phone",
                              "email",
                              "cellphone"
                            ]
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ]
                      }
                    },
                    "svFields": {
                      "type": "object",
                      "properties": {
                        "nrc": {
                          "type": "string",
                          "nullable": true
                        },
                        "nit": {
                          "type": "string",
                          "nullable": true
                        },
                        "dui": {
                          "type": "string",
                          "nullable": true
                        },
                        "taxerType": {
                          "type": "number",
                          "nullable": true,
                          "enum": [
                            1,
                            2,
                            3
                          ]
                        },
                        "economicActivity": {
                          "type": "string",
                          "nullable": true
                        }
                      },
                      "required": [
                        "nrc",
                        "nit",
                        "dui",
                        "taxerType",
                        "economicActivity"
                      ],
                      "nullable": true
                    }
                  },
                  "required": [
                    "branch",
                    "id",
                    "internalId",
                    "name",
                    "name1",
                    "name2",
                    "name3",
                    "lastname1",
                    "lastname2",
                    "lastname3",
                    "shortName",
                    "type",
                    "personType",
                    "personTypeNatural",
                    "directory",
                    "svFields"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Proveedores.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe un registro activo con ese internalId en tu empresa, o el id que enviaste ya existe (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Proveedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Agrega un registro nuevo al catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1ProvidersGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Listar proveedores",
        "parameters": [
          {
            "name": "internalId",
            "required": false,
            "in": "query",
            "description": "Filtra por la referencia externa del integrador (coincidencia exacta, sensible a mayúsculas).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Página (desde 1). Por omisión 1.",
            "schema": {
              "minimum": 1,
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Registros por página (1 a 100). Por omisión 20.",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "branch": {
                            "type": "object",
                            "properties": {
                              "country": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "number",
                                    "description": "Id interno de Openbox Cloud."
                                  },
                                  "code": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                                  },
                                  "name": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "code",
                                  "name"
                                ],
                                "nullable": true
                              },
                              "state": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "number",
                                    "description": "Id interno de Openbox Cloud."
                                  },
                                  "code": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                                  },
                                  "name": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "code",
                                  "name"
                                ],
                                "nullable": true
                              },
                              "city": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "number",
                                    "description": "Id interno de Openbox Cloud."
                                  },
                                  "code": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                                  },
                                  "name": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "code",
                                  "name"
                                ],
                                "nullable": true
                              },
                              "address1": {
                                "type": "string"
                              },
                              "address2": {
                                "type": "string",
                                "nullable": true
                              },
                              "directory": {
                                "nullable": true,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "enum": [
                                        "phone",
                                        "email",
                                        "cellphone"
                                      ]
                                    },
                                    "value": {
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ]
                                }
                              }
                            },
                            "required": [
                              "country",
                              "state",
                              "city",
                              "address1",
                              "address2",
                              "directory"
                            ],
                            "nullable": true,
                            "description": "Sucursal principal (la más antigua). `null` solo en un proveedor de la web sin sucursal."
                          },
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string",
                            "nullable": true
                          },
                          "name": {
                            "type": "string",
                            "nullable": true
                          },
                          "name1": {
                            "type": "string",
                            "nullable": true
                          },
                          "name2": {
                            "type": "string",
                            "nullable": true
                          },
                          "name3": {
                            "type": "string",
                            "nullable": true
                          },
                          "lastname1": {
                            "type": "string",
                            "nullable": true
                          },
                          "lastname2": {
                            "type": "string",
                            "nullable": true
                          },
                          "lastname3": {
                            "type": "string",
                            "nullable": true
                          },
                          "shortName": {
                            "type": "string"
                          },
                          "type": {
                            "enum": [
                              1,
                              2,
                              3
                            ],
                            "type": "number"
                          },
                          "personType": {
                            "enum": [
                              1,
                              2,
                              3
                            ],
                            "type": "number"
                          },
                          "personTypeNatural": {
                            "nullable": true,
                            "enum": [
                              1,
                              2
                            ],
                            "type": "number"
                          },
                          "directory": {
                            "nullable": true,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "phone",
                                    "email",
                                    "cellphone"
                                  ]
                                },
                                "value": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ]
                            }
                          },
                          "svFields": {
                            "type": "object",
                            "properties": {
                              "nrc": {
                                "type": "string",
                                "nullable": true
                              },
                              "nit": {
                                "type": "string",
                                "nullable": true
                              },
                              "dui": {
                                "type": "string",
                                "nullable": true
                              },
                              "taxerType": {
                                "type": "number",
                                "nullable": true,
                                "enum": [
                                  1,
                                  2,
                                  3
                                ]
                              },
                              "economicActivity": {
                                "type": "string",
                                "nullable": true
                              }
                            },
                            "required": [
                              "nrc",
                              "nit",
                              "dui",
                              "taxerType",
                              "economicActivity"
                            ],
                            "nullable": true
                          }
                        },
                        "required": [
                          "branch",
                          "id",
                          "internalId",
                          "name",
                          "name1",
                          "name2",
                          "name3",
                          "lastname1",
                          "lastname2",
                          "lastname3",
                          "shortName",
                          "type",
                          "personType",
                          "personTypeNatural",
                          "directory",
                          "svFields"
                        ]
                      }
                    },
                    "count": {
                      "type": "number"
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "data",
                    "count",
                    "page",
                    "limit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Proveedores.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Proveedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Con filtro opcional por tu internalId.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/providers/{id}": {
      "get": {
        "operationId": "partnersV1ProvidersGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar proveedor",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "branch": {
                      "type": "object",
                      "properties": {
                        "country": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "state": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "city": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "address1": {
                          "type": "string"
                        },
                        "address2": {
                          "type": "string",
                          "nullable": true
                        },
                        "directory": {
                          "nullable": true,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "phone",
                                  "email",
                                  "cellphone"
                                ]
                              },
                              "value": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "value"
                            ]
                          }
                        }
                      },
                      "required": [
                        "country",
                        "state",
                        "city",
                        "address1",
                        "address2",
                        "directory"
                      ],
                      "nullable": true,
                      "description": "Sucursal principal (la más antigua). `null` solo en un proveedor de la web sin sucursal."
                    },
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string",
                      "nullable": true
                    },
                    "name1": {
                      "type": "string",
                      "nullable": true
                    },
                    "name2": {
                      "type": "string",
                      "nullable": true
                    },
                    "name3": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname1": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname2": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname3": {
                      "type": "string",
                      "nullable": true
                    },
                    "shortName": {
                      "type": "string"
                    },
                    "type": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personTypeNatural": {
                      "nullable": true,
                      "enum": [
                        1,
                        2
                      ],
                      "type": "number"
                    },
                    "directory": {
                      "nullable": true,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "phone",
                              "email",
                              "cellphone"
                            ]
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ]
                      }
                    },
                    "svFields": {
                      "type": "object",
                      "properties": {
                        "nrc": {
                          "type": "string",
                          "nullable": true
                        },
                        "nit": {
                          "type": "string",
                          "nullable": true
                        },
                        "dui": {
                          "type": "string",
                          "nullable": true
                        },
                        "taxerType": {
                          "type": "number",
                          "nullable": true,
                          "enum": [
                            1,
                            2,
                            3
                          ]
                        },
                        "economicActivity": {
                          "type": "string",
                          "nullable": true
                        }
                      },
                      "required": [
                        "nrc",
                        "nit",
                        "dui",
                        "taxerType",
                        "economicActivity"
                      ],
                      "nullable": true
                    }
                  },
                  "required": [
                    "branch",
                    "id",
                    "internalId",
                    "name",
                    "name1",
                    "name2",
                    "name3",
                    "lastname1",
                    "lastname2",
                    "lastname3",
                    "shortName",
                    "type",
                    "personType",
                    "personTypeNatural",
                    "directory",
                    "svFields"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Proveedores.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El proveedor no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Proveedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "patch": {
        "operationId": "partnersV1ProvidersUpdateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Actualizar proveedor",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "branch": {
                    "type": "object",
                    "properties": {
                      "country": {
                        "type": "string",
                        "pattern": "^(\\d{4}|[A-Za-z]{2})$",
                        "description": "SVCode de 4 dígitos o código ISO 3166-1 alfa-2 (ej. \"PA\"), siempre como texto."
                      },
                      "state": {
                        "type": "string",
                        "pattern": "^\\d{2}$",
                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                      },
                      "city": {
                        "type": "string",
                        "pattern": "^\\d{2}$",
                        "description": "SVCode de 2 dígitos, siempre como texto (ej. \"06\"); el municipio se busca dentro de su departamento."
                      },
                      "directory": {
                        "nullable": true,
                        "description": "Reemplaza los contactos de la sucursal enteros. `null`: sin contactos (si la regla lo admite).",
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "phone",
                                "email",
                                "cellphone"
                              ]
                            },
                            "value": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "type",
                            "value"
                          ]
                        }
                      },
                      "address1": {
                        "type": "string"
                      },
                      "address2": {
                        "type": "string",
                        "nullable": true
                      }
                    },
                    "description": "Sucursal principal: se combina campo a campo con la guardada."
                  },
                  "directory": {
                    "nullable": true,
                    "description": "Reemplaza los contactos enteros. `null`: sin contactos (si la regla lo admite).",
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "phone",
                            "email",
                            "cellphone"
                          ]
                        },
                        "value": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "value"
                      ]
                    }
                  },
                  "svFields": {
                    "type": "object",
                    "properties": {
                      "nrc": {
                        "type": "string",
                        "nullable": true
                      },
                      "nit": {
                        "type": "string",
                        "nullable": true,
                        "pattern": "/^\\d{4}-\\d{6}-\\d{3}-\\d$/"
                      },
                      "dui": {
                        "type": "string",
                        "nullable": true,
                        "pattern": "/^\\d{8}-\\d$/"
                      },
                      "taxerType": {
                        "type": "number",
                        "nullable": true
                      },
                      "economicActivity": {
                        "type": "string",
                        "nullable": true
                      }
                    },
                    "nullable": true,
                    "description": "Datos fiscales: se combinan campo a campo; `null` los limpia todos (si la regla lo admite)."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: la quita."
                  },
                  "name": {
                    "type": "string",
                    "nullable": true
                  },
                  "name1": {
                    "type": "string",
                    "nullable": true
                  },
                  "name2": {
                    "type": "string",
                    "nullable": true
                  },
                  "name3": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname1": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname2": {
                    "type": "string",
                    "nullable": true
                  },
                  "lastname3": {
                    "type": "string",
                    "nullable": true
                  },
                  "shortName": {
                    "type": "string",
                    "description": "Omitido conserva; `null` o vacío da 400 (requerido, como en la web)."
                  },
                  "type": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "personType": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "personTypeNatural": {
                    "type": "number",
                    "nullable": true,
                    "enum": [
                      1,
                      2
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "branch": {
                      "type": "object",
                      "properties": {
                        "country": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "state": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "city": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "number",
                              "description": "Id interno de Openbox Cloud."
                            },
                            "code": {
                              "type": "string",
                              "nullable": true,
                              "description": "Código que la plataforma emite al MH: ISO 3166-1 alfa-2 en el país (CAT-020), SVCode de 2 dígitos en departamento y municipio. `null` si el registro no lo tiene."
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "code",
                            "name"
                          ],
                          "nullable": true
                        },
                        "address1": {
                          "type": "string"
                        },
                        "address2": {
                          "type": "string",
                          "nullable": true
                        },
                        "directory": {
                          "nullable": true,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "phone",
                                  "email",
                                  "cellphone"
                                ]
                              },
                              "value": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "value"
                            ]
                          }
                        }
                      },
                      "required": [
                        "country",
                        "state",
                        "city",
                        "address1",
                        "address2",
                        "directory"
                      ],
                      "nullable": true,
                      "description": "Sucursal principal (la más antigua). `null` solo en un proveedor de la web sin sucursal."
                    },
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string",
                      "nullable": true
                    },
                    "name1": {
                      "type": "string",
                      "nullable": true
                    },
                    "name2": {
                      "type": "string",
                      "nullable": true
                    },
                    "name3": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname1": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname2": {
                      "type": "string",
                      "nullable": true
                    },
                    "lastname3": {
                      "type": "string",
                      "nullable": true
                    },
                    "shortName": {
                      "type": "string"
                    },
                    "type": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "personTypeNatural": {
                      "nullable": true,
                      "enum": [
                        1,
                        2
                      ],
                      "type": "number"
                    },
                    "directory": {
                      "nullable": true,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "phone",
                              "email",
                              "cellphone"
                            ]
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ]
                      }
                    },
                    "svFields": {
                      "type": "object",
                      "properties": {
                        "nrc": {
                          "type": "string",
                          "nullable": true
                        },
                        "nit": {
                          "type": "string",
                          "nullable": true
                        },
                        "dui": {
                          "type": "string",
                          "nullable": true
                        },
                        "taxerType": {
                          "type": "number",
                          "nullable": true,
                          "enum": [
                            1,
                            2,
                            3
                          ]
                        },
                        "economicActivity": {
                          "type": "string",
                          "nullable": true
                        }
                      },
                      "required": [
                        "nrc",
                        "nit",
                        "dui",
                        "taxerType",
                        "economicActivity"
                      ],
                      "nullable": true
                    }
                  },
                  "required": [
                    "branch",
                    "id",
                    "internalId",
                    "name",
                    "name1",
                    "name2",
                    "name3",
                    "lastname1",
                    "lastname2",
                    "lastname3",
                    "shortName",
                    "type",
                    "personType",
                    "personTypeNatural",
                    "directory",
                    "svFields"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Proveedores.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El proveedor no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Otro registro activo de tu empresa ya usa ese internalId (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Proveedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Actualización parcial: solo cambian los campos que envíes.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "delete": {
        "operationId": "partnersV1ProvidersDeleteSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Eliminar proveedor",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "message"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Proveedores.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El proveedor no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Proveedores"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Quita el registro del catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/services": {
      "post": {
        "operationId": "partnersV1ServicesCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear servicio",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "UUID de Openbox Cloud propuesto por el integrador (8-4-4-4-12 por forma). Omitido: lo genera Openbox Cloud."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: sin internalId."
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "price": {
                    "type": "number",
                    "description": "Precio respetando los decimales configurados en la empresa (`DECIMAL_PLACES`).",
                    "minimum": 0
                  },
                  "incIva": {
                    "type": "boolean"
                  },
                  "sellingType": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  }
                },
                "required": [
                  "name",
                  "description",
                  "price",
                  "incIva",
                  "sellingType"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "price": {
                      "type": "number"
                    },
                    "incIva": {
                      "type": "boolean"
                    },
                    "sellingType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "description",
                    "price",
                    "incIva",
                    "sellingType"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Servicios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe un registro activo con ese internalId en tu empresa, o el id que enviaste ya existe (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Servicios"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Agrega un registro nuevo al catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1ServicesGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Listar servicios",
        "parameters": [
          {
            "name": "internalId",
            "required": false,
            "in": "query",
            "description": "Filtra por la referencia externa del integrador (coincidencia exacta, sensible a mayúsculas).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Página (desde 1). Por omisión 1.",
            "schema": {
              "minimum": 1,
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Registros por página (1 a 100). Por omisión 20.",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string",
                            "nullable": true
                          },
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "price": {
                            "type": "number"
                          },
                          "incIva": {
                            "type": "boolean"
                          },
                          "sellingType": {
                            "enum": [
                              1,
                              2,
                              3
                            ],
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "internalId",
                          "name",
                          "description",
                          "price",
                          "incIva",
                          "sellingType"
                        ]
                      }
                    },
                    "count": {
                      "type": "number"
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "data",
                    "count",
                    "page",
                    "limit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Servicios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Servicios"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Con filtro opcional por tu internalId.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/services/{id}": {
      "get": {
        "operationId": "partnersV1ServicesGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar servicio",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "price": {
                      "type": "number"
                    },
                    "incIva": {
                      "type": "boolean"
                    },
                    "sellingType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "description",
                    "price",
                    "incIva",
                    "sellingType"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Servicios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El servicio no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Servicios"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "patch": {
        "operationId": "partnersV1ServicesUpdateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Actualizar servicio",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: la quita."
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "price": {
                    "type": "number",
                    "description": "Precio respetando los decimales configurados en la empresa (`DECIMAL_PLACES`).",
                    "minimum": 0
                  },
                  "incIva": {
                    "type": "boolean"
                  },
                  "sellingType": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "price": {
                      "type": "number"
                    },
                    "incIva": {
                      "type": "boolean"
                    },
                    "sellingType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "description",
                    "price",
                    "incIva",
                    "sellingType"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Servicios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El servicio no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Otro registro activo de tu empresa ya usa ese internalId (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Servicios"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Actualización parcial: solo cambian los campos que envíes.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "delete": {
        "operationId": "partnersV1ServicesDeleteSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Eliminar servicio",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "message"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Servicios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El servicio no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Servicios"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Quita el registro del catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/products": {
      "post": {
        "operationId": "partnersV1ProductsCreateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Crear producto",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "UUID de Openbox Cloud propuesto por el integrador (8-4-4-4-12 por forma). Omitido: lo genera Openbox Cloud."
                  },
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: sin internalId."
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string",
                    "nullable": true
                  },
                  "code": {
                    "type": "string",
                    "nullable": true
                  },
                  "barcode": {
                    "type": "string",
                    "nullable": true
                  },
                  "price": {
                    "type": "number",
                    "description": "Precio respetando los decimales configurados en la empresa (`DECIMAL_PLACES`).",
                    "minimum": 0
                  },
                  "incIva": {
                    "type": "boolean"
                  },
                  "sellingType": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "unit": {
                    "type": "number",
                    "description": "Código de unidad de medida de Hacienda (lista del MH que acepta la venta). Omitido: 59 (Unidad).",
                    "enum": [
                      1,
                      2,
                      6,
                      9,
                      10,
                      13,
                      15,
                      18,
                      20,
                      22,
                      23,
                      24,
                      26,
                      30,
                      32,
                      33,
                      34,
                      36,
                      37,
                      38,
                      39,
                      40,
                      42,
                      43,
                      44,
                      45,
                      46,
                      47,
                      49,
                      50,
                      51,
                      52,
                      53,
                      54,
                      55,
                      56,
                      57,
                      58,
                      59,
                      99
                    ]
                  }
                },
                "required": [
                  "name",
                  "price",
                  "incIva",
                  "sellingType"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string",
                      "nullable": true
                    },
                    "code": {
                      "type": "string",
                      "nullable": true
                    },
                    "barcode": {
                      "type": "string",
                      "nullable": true
                    },
                    "price": {
                      "type": "number"
                    },
                    "incIva": {
                      "type": "boolean"
                    },
                    "sellingType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "unit": {
                      "enum": [
                        1,
                        2,
                        6,
                        9,
                        10,
                        13,
                        15,
                        18,
                        20,
                        22,
                        23,
                        24,
                        26,
                        30,
                        32,
                        33,
                        34,
                        36,
                        37,
                        38,
                        39,
                        40,
                        42,
                        43,
                        44,
                        45,
                        46,
                        47,
                        49,
                        50,
                        51,
                        52,
                        53,
                        54,
                        55,
                        56,
                        57,
                        58,
                        59,
                        99
                      ],
                      "type": "number"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "description",
                    "code",
                    "barcode",
                    "price",
                    "incIva",
                    "sellingType",
                    "unit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Inventarios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Ya existe un registro activo con ese internalId en tu empresa, o el id que enviaste ya existe (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Productos"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Agrega un registro nuevo al catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "get": {
        "operationId": "partnersV1ProductsGetMany",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Listar productos",
        "parameters": [
          {
            "name": "internalId",
            "required": false,
            "in": "query",
            "description": "Filtra por la referencia externa del integrador (coincidencia exacta, sensible a mayúsculas).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Página (desde 1). Por omisión 1.",
            "schema": {
              "minimum": 1,
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Registros por página (1 a 100). Por omisión 20.",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "internalId": {
                            "type": "string",
                            "nullable": true
                          },
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string",
                            "nullable": true
                          },
                          "code": {
                            "type": "string",
                            "nullable": true
                          },
                          "barcode": {
                            "type": "string",
                            "nullable": true
                          },
                          "price": {
                            "type": "number"
                          },
                          "incIva": {
                            "type": "boolean"
                          },
                          "sellingType": {
                            "enum": [
                              1,
                              2,
                              3
                            ],
                            "type": "number"
                          },
                          "unit": {
                            "enum": [
                              1,
                              2,
                              6,
                              9,
                              10,
                              13,
                              15,
                              18,
                              20,
                              22,
                              23,
                              24,
                              26,
                              30,
                              32,
                              33,
                              34,
                              36,
                              37,
                              38,
                              39,
                              40,
                              42,
                              43,
                              44,
                              45,
                              46,
                              47,
                              49,
                              50,
                              51,
                              52,
                              53,
                              54,
                              55,
                              56,
                              57,
                              58,
                              59,
                              99
                            ],
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "internalId",
                          "name",
                          "description",
                          "code",
                          "barcode",
                          "price",
                          "incIva",
                          "sellingType",
                          "unit"
                        ]
                      }
                    },
                    "count": {
                      "type": "number"
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "data",
                    "count",
                    "page",
                    "limit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Inventarios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Productos"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Con filtro opcional por tu internalId.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    },
    "/partners/v1/products/{id}": {
      "get": {
        "operationId": "partnersV1ProductsGetSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Consultar producto",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string",
                      "nullable": true
                    },
                    "code": {
                      "type": "string",
                      "nullable": true
                    },
                    "barcode": {
                      "type": "string",
                      "nullable": true
                    },
                    "price": {
                      "type": "number"
                    },
                    "incIva": {
                      "type": "boolean"
                    },
                    "sellingType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "unit": {
                      "enum": [
                        1,
                        2,
                        6,
                        9,
                        10,
                        13,
                        15,
                        18,
                        20,
                        22,
                        23,
                        24,
                        26,
                        30,
                        32,
                        33,
                        34,
                        36,
                        37,
                        38,
                        39,
                        40,
                        42,
                        43,
                        44,
                        45,
                        46,
                        47,
                        49,
                        50,
                        51,
                        52,
                        53,
                        54,
                        55,
                        56,
                        57,
                        58,
                        59,
                        99
                      ],
                      "type": "number"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "description",
                    "code",
                    "barcode",
                    "price",
                    "incIva",
                    "sellingType",
                    "unit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Inventarios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El producto no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Productos"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Por el id que Openbox Cloud asignó al registro.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "patch": {
        "operationId": "partnersV1ProductsUpdateSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Actualizar producto",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "internalId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Referencia externa del integrador; única por empresa entre registros activos. `null`: la quita."
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string",
                    "nullable": true
                  },
                  "code": {
                    "type": "string",
                    "nullable": true
                  },
                  "barcode": {
                    "type": "string",
                    "nullable": true
                  },
                  "price": {
                    "type": "number",
                    "description": "Precio respetando los decimales configurados en la empresa (`DECIMAL_PLACES`).",
                    "minimum": 0
                  },
                  "incIva": {
                    "type": "boolean"
                  },
                  "sellingType": {
                    "type": "number",
                    "enum": [
                      1,
                      2,
                      3
                    ]
                  },
                  "unit": {
                    "type": "number",
                    "description": "Código de unidad de medida de Hacienda (lista del MH que acepta la venta).",
                    "enum": [
                      1,
                      2,
                      6,
                      9,
                      10,
                      13,
                      15,
                      18,
                      20,
                      22,
                      23,
                      24,
                      26,
                      30,
                      32,
                      33,
                      34,
                      36,
                      37,
                      38,
                      39,
                      40,
                      42,
                      43,
                      44,
                      45,
                      46,
                      47,
                      49,
                      50,
                      51,
                      52,
                      53,
                      54,
                      55,
                      56,
                      57,
                      58,
                      59,
                      99
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "internalId": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string",
                      "nullable": true
                    },
                    "code": {
                      "type": "string",
                      "nullable": true
                    },
                    "barcode": {
                      "type": "string",
                      "nullable": true
                    },
                    "price": {
                      "type": "number"
                    },
                    "incIva": {
                      "type": "boolean"
                    },
                    "sellingType": {
                      "enum": [
                        1,
                        2,
                        3
                      ],
                      "type": "number"
                    },
                    "unit": {
                      "enum": [
                        1,
                        2,
                        6,
                        9,
                        10,
                        13,
                        15,
                        18,
                        20,
                        22,
                        23,
                        24,
                        26,
                        30,
                        32,
                        33,
                        34,
                        36,
                        37,
                        38,
                        39,
                        40,
                        42,
                        43,
                        44,
                        45,
                        46,
                        47,
                        49,
                        50,
                        51,
                        52,
                        53,
                        54,
                        55,
                        56,
                        57,
                        58,
                        59,
                        99
                      ],
                      "type": "number"
                    }
                  },
                  "required": [
                    "id",
                    "internalId",
                    "name",
                    "description",
                    "code",
                    "barcode",
                    "price",
                    "incIva",
                    "sellingType",
                    "unit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Inventarios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El producto no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Otro registro activo de tu empresa ya usa ese internalId (code INTERNAL_ID_DUPLICATED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 409
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores.",
                      "example": "INTERNAL_ID_DUPLICATED"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Productos"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Actualización parcial: solo cambian los campos que envíes.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      },
      "delete": {
        "operationId": "partnersV1ProductsDeleteSingle",
        "x-openbox-availability": {
          "status": "available"
        },
        "summary": "Eliminar producto",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "UUID de Openbox Cloud del registro: 8-4-4-4-12 hexadecimal, sin exigir versión RFC.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "message"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "La petición no cumple el contrato: cuerpo, parámetros o id con forma inválida. `message` lista el primer problema de cada campo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Falta el token, venció o lo revocó un inicio de sesión posterior con la misma llave.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "El token no corresponde a una llave de API de Partners, o el perfil de la llave no tiene acceso al módulo de Inventarios.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 403
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "El producto no existe en tu empresa.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "statusCode",
                    "message",
                    "error"
                  ],
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 404
                    },
                    "message": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "error": {
                      "type": "string",
                      "description": "Texto libre de diagnóstico. Su valor puede cambiar sin aviso: decide con statusCode y code."
                    },
                    "code": {
                      "type": "string",
                      "description": "Código estable, solo en algunos errores."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Productos"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "description": "Quita el registro del catálogo de tu empresa.",
        "x-badges": [
          {
            "name": "Disponible",
            "position": "after",
            "color": "#15803d"
          }
        ]
      }
    }
  },
  "info": {
    "title": "Openbox Cloud Partners API",
    "version": "1.0",
    "description": "Contrato de la API de Partners v1 de Openbox Cloud. Guías, estado y ejemplos en el Developer Center (https://developers.openbox.cloud)."
  },
  "tags": [
    {
      "name": "Autenticación",
      "description": "Cambia la llave y el secreto de tu empresa por un token de acceso, que envías como `Authorization: Bearer <token>` en cada petición. Cada inicio de sesión revoca los tokens anteriores de la misma llave: reutiliza el token y vuelve a iniciar sesión solo cuando una petición responda 401."
    },
    {
      "name": "Clientes",
      "description": "Los clientes a quienes vendes. La venta los usa en `header.customer`, por su id de Openbox Cloud o como objeto completo. Si registras cada cliente con tu `internalId` (es opcional), después lo buscas con el filtro del listado. Las operaciones exigen el módulo Clientes en el perfil de tu llave."
    },
    {
      "name": "Proveedores",
      "description": "Los proveedores a quienes compras. La compra los usa en `header.provider`. Las operaciones exigen el módulo Proveedores en el perfil de tu llave."
    },
    {
      "name": "Servicios",
      "description": "Los servicios que vendes. La venta los usa en cada línea, en `details[].service`. Las líneas de una compra no salen de este catálogo: describen lo comprado en la propia compra. Las operaciones exigen el módulo Servicios en el perfil de tu llave."
    },
    {
      "name": "Productos",
      "description": "Los productos que vendes, con su inventario. La venta los usa en cada línea, en `details[].product`. Las operaciones exigen el módulo Inventarios en el perfil de tu llave."
    },
    {
      "name": "Vendedores",
      "description": "Las personas que venden en nombre de tu empresa. La venta los usa en `header.invoicesSeller`, y la zona de venta va dentro del vendedor, no en la cabecera. Las operaciones exigen el módulo Facturación en el perfil de tu llave."
    },
    {
      "name": "Zonas",
      "description": "Las zonas de venta de tu empresa. Una zona no va en la cabecera de la venta: va dentro del vendedor, en `header.invoicesSeller.zone`. Las operaciones exigen el módulo Facturación en el perfil de tu llave."
    },
    {
      "name": "Condiciones de pago de venta",
      "description": "Las condiciones de pago que ofreces al vender, como contado o crédito a 30 días. La venta las usa en `header.paymentCondition`. Es un catálogo aparte del de las condiciones de pago de compra. Las operaciones exigen el módulo Facturación en el perfil de tu llave."
    },
    {
      "name": "Condiciones de pago de compra",
      "description": "Las condiciones de pago con que compras. La compra las usa en `header.paymentCondition`. Es un catálogo aparte del de las condiciones de pago de venta. Las operaciones exigen el módulo Compras en el perfil de tu llave."
    },
    {
      "name": "Ventas",
      "description": "Ventas electrónicas: comprobante de crédito fiscal (CCF), factura de consumidor final (FCF), nota de crédito (NC) y factura de exportación (FEX). Openbox Cloud presenta cada venta al Ministerio de Hacienda y te devuelve su estado; también la consultas y la anulas. Cada registro del catálogo va por su id de Openbox Cloud o como objeto, en el mismo campo. Las operaciones exigen el módulo Facturación en el perfil de tu llave."
    },
    {
      "name": "Compras",
      "description": "Compras electrónicas: la Factura de Sujeto Excluido (FSE), por cada compra a quien no emite documento. Openbox Cloud la presenta al Ministerio de Hacienda y te devuelve su estado; también la consultas. Las operaciones exigen el módulo Compras en el perfil de tu llave."
    }
  ],
  "servers": [
    {
      "url": "https://demo-api.openbox.cloud",
      "description": "Demo: pruebas, conectado al Ministerio de Hacienda de pruebas (ambiente 00)"
    },
    {
      "url": "https://production-api.openbox.cloud",
      "description": "Producción: documentos con validez fiscal ante el Ministerio de Hacienda (ambiente 01)"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    }
  }
}
