--- title: "Crear documento contable" method: POST path: "/api/v1/contabilidad/crearDocContable" tags: ["Contabilidad"] --- # Crear documento contable `POST /api/v1/contabilidad/crearDocContable`

Crear documento contable

https://api.worldoffice.cloud/api/v1/contabilidad/crearDocContable
La petición debe incluir en su body la fecha de creación del documento, el ID de la empresa a la que se desea asociar el documento, el ID del tercero receptor y un ID prefijo opcional. Por favor, asegúrese de proporcionar toda la información necesaria para que el proceso sea completado correctamentedocumentoTipo -> Codigo tipo documento que se quiere registrar (RC -> RECIBO DE CAJA, NC -> NOTA DE CONTABILIDAD, CE -> COMPROBANTE DE EGRESO, CV -> COSTOS DE VENTAS, NO -> Nomina, DP -> Depreciación)fecha -> Fecha del documento formato YYYY-MM-DD,
empresaId -> Id empresa,
terceroId -> Id tercero,
prefijoId -> Id prefijo,
concepto -> Concepto a registrar,
asientos -> Arreglo de asientos contables

Petición de servicio:
https://api.worldoffice.cloud/api/v1/contabilidad/crearDocContable
{
  documentoTipo: NC,
  fecha: 2023-05-05,
  empresaId: 1,
  terceroId: 1111,
  prefijoId: 1,
  concepto: NOTA DE CONTABILIDAD,
  asientos: []
}

Respuesta en el contenido de la petición:
data: {
  id: integer,
  fecha: string,
  numero: integer,
  prefijo: {
    id: integer,
    nombre: string,
    descripcion: string
  }
  documentoTipo: {
    id: integer
    codigoDocumento: string
    nombreDocumento: string
  }
  empresa: {
    id: integer
    nombre: string
    prefijo: string
    identificacion: string
    digitoVerificacion: integer
    digitoVerificacionGenerado: boolean
    senPrincipal: boolean
    numeroEstablecimientos: integer
    tercero: {
      id: integer
      terceroTipoIdentificacion: {
        id: integer
        abreviatura: string
        nombre: string
        codigo: string
        senEsEmpresa: boolean
        senManejaDV: boolean
        ubicacionPais: {
          id: integer
          nombre: string
          codigo: string
          codAlterno: string
        }
      }
      identificacion: string
      digitoVerificacion: integer
      digitoVerificacionGenerado: boolean
      primerNombre: string
      segundoNombre: string
      primerApellido: string
      segundoApellido: string
      nombreCompleto: string
      ciudad: {
        id: integer
        nombre: string
        codigo: string
        senSistema: boolean
        ubicacionDepartamento: {
          id: integer
          nombre: string
          codigo: string
          senSistema: boolean
          ubicacionPais: {
            id: integer
            nombre: string
            codigo: string
            codAlterno: string
          }
        }
      }
      codigo: string
      senActivo: boolean
      senManejaNomina: boolean
      atributos: boolean
      tarifaICA: integer
      aplicaICAVentas: boolean
      terceroTipos: [
        {
          id: integer
          codigo: string
          nombre: string
        }
      ]
    }
    ubicacionCiudad: {
      id: integer
      nombre: string
      codigo: string
      senSistema: boolean
      ubicacionDepartamento: {
        id: integer
        nombre: string
        codigo: string
        senSistema: boolean
        ubicacionPais: {
          id: integer
          nombre: string
          codigo: string
          codAlterno: string
        }
      }
    }
    infoTributariaAdicional: string
    responsabilidadFiscal: [
      {
        id: integer
        codigo: string
        significado: string
      }
    ]
  }
  terceroExterno: {
    id: integer
    nombreCompleto: string
    primerNombre: string
    segundoNombre: string
    primerApellido: string
    segundoApellido: string
    terceroTipoIdentificacion: string
    identificacion: string
    terceroTipoContribuyente: string
    terceroClasificacionAdministradorImpuesto: string
    terceroTipos: [
      {
        id: integer
        codigo: string
        nombre: string
      }
    ]
    senCupoCredito: boolean
    terceroVendedorPredeterminado: {
      id: integer
      nombreCompleto: string
      primerNombre: string
      segundoNombre: string
      primerApellido: string
      segundoApellido: string
      terceroTipoIdentificacion: string
      identificacion: string
    }
    formaPagoPredeterminada: {
      id: integer
      codigo: string
      nombre: string
      senManejaCupoCredito: boolean
    }
    listaPrecioPredeterminada: {
      id: integer
      nombre: string
    }
  }
  terceroInterno: {
    id: integer
    nombreCompleto: string
    primerNombre: string
    segundoNombre: string
    primerApellido: string
    segundoApellido: string
    terceroTipoIdentificacion: string
    identificacion: string
  }
  direccionTerceroExterno: {
    id: integer
    direccion: string
    ciudad: string
    telefonoPrincipal: string
    sucursal: string
    senPrincipal: boolean
  }
  formaPago: {
    id: integer
    codigo: string
    nombre: string
    senManejaCupoCredito: boolean
  }
  moneda: {
    id: integer
    codigo: string
    nombre: string
    separadorDecimales: string
    separadorMiles: string
    cantidadDecimales: integer
    simbolo: string
    tieneTRM: boolean
  }
  concepto: string
  trm: integer
  senContabilizado: boolean
  documentoEncabezadosEstados: [
    {
      id: integer
      codigo: String
      nombre: string
    }
  ]
  numeroExterno: string
  prefijoExterno: string
  docAsociado: {
    id: integer
    prefijo: {
      id: integer
      nombre: string
      descripcion: string
    }
    numero: integer
    fecha: string
    moneda: {
      id: integer
      codigo: string
      nombre: string
      separadorDecimales: string
      separadorMiles: string
      cantidadDecimales: integer
      simbolo: string
      tieneTRM: boolean
    }
    documentoTipo: {
      id: integer
      codigoDocumento: string
      nombreDocumento: string
    }
    trm: integer
    versionFe: integer
    cufe: string
  }
  documentoMotivoGeneracion: {
    id: integer
    codigo: string
    motivo: string
  }
  documentoTipoNotaCredito: {
    id: integer
    codigo: strin
    tipoNotaCredito: string
    efectoEnInventario: integer
  }
  tieneRenglones: boolean
  senGenerado: boolean
  elaboradoPor: {
    id: integer
    nombres: string
  }
  tieneResolucionElectronica: boolean
  atributosRequeridos: boolean
  atributosEncabezado: boolean
  atributosRenglones: boolean
  historialPrefijoPos: {
    numero: integer
    nombrePrefijo: string
  }
}
## Request body - CrearDocumentoRecaudosAPI - `documentoId` integer - `documentoTipo` string, required - `fecha` string, required - `empresaId` integer, required - `terceroId` integer, required - `prefijoId` integer - `concepto` string - `asientos` CrearMovimientoContableAPI[] - `asientoId` integer - `cuentaContableId` integer, required - `concepto` string - `terceroId` integer - `valorDebito` number, required - `valorCredito` number, required - `centroCostosId` integer - `fechaVencimiento` string, required - `retencionBase` number - `retencionPorcentaje` number - `formaPago` CrearDocumentoPagoAPI, required - `formaPagoId` integer - `numeroDocumento` string - `fechaVencimiento` string - `terceroId` integer - `cuentasId` integer[] ## Response `201` Se creo el documento contable exitosamente - ResponseAPIDocumentoEncabezadoPOJO - `status` '100 CONTINUE' | '101 SWITCHING_PROTOCOLS' | '102 PROCESSING' | '103 EARLY_HINTS' | '103 CHECKPOINT' | '200 OK' | '201 CREATED' | '202 ACCEPTED' | '203 NON_AUTHORITATIVE_INFORMATION' | '204 NO_CONTENT' | '205 RESET_CONTENT' | '206 PARTIAL_CONTENT' | '207 MULTI_STATUS' | '208 ALREADY_REPORTED' | '226 IM_USED' | '300 MULTIPLE_CHOICES' | '301 MOVED_PERMANENTLY' | '302 FOUND' | '302 MOVED_TEMPORARILY' | '303 SEE_OTHER' | '304 NOT_MODIFIED' | '305 USE_PROXY' | '307 TEMPORARY_REDIRECT' | '308 PERMANENT_REDIRECT' | '400 BAD_REQUEST' | '401 UNAUTHORIZED' | '402 PAYMENT_REQUIRED' | '403 FORBIDDEN' | '404 NOT_FOUND' | '405 METHOD_NOT_ALLOWED' | '406 NOT_ACCEPTABLE' | '407 PROXY_AUTHENTICATION_REQUIRED' | '408 REQUEST_TIMEOUT' | '409 CONFLICT' | '410 GONE' | '411 LENGTH_REQUIRED' | '412 PRECONDITION_FAILED' | '413 PAYLOAD_TOO_LARGE' | '413 REQUEST_ENTITY_TOO_LARGE' | '414 URI_TOO_LONG' | '414 REQUEST_URI_TOO_LONG' | '415 UNSUPPORTED_MEDIA_TYPE' | '416 REQUESTED_RANGE_NOT_SATISFIABLE' | '417 EXPECTATION_FAILED' | '418 I_AM_A_TEAPOT' | '419 INSUFFICIENT_SPACE_ON_RESOURCE' | '420 METHOD_FAILURE' | '421 DESTINATION_LOCKED' | '422 UNPROCESSABLE_ENTITY' | '423 LOCKED' | '424 FAILED_DEPENDENCY' | '425 TOO_EARLY' | '426 UPGRADE_REQUIRED' | '428 PRECONDITION_REQUIRED' | '429 TOO_MANY_REQUESTS' | '431 REQUEST_HEADER_FIELDS_TOO_LARGE' | '451 UNAVAILABLE_FOR_LEGAL_REASONS' | '500 INTERNAL_SERVER_ERROR' | '501 NOT_IMPLEMENTED' | '502 BAD_GATEWAY' | '503 SERVICE_UNAVAILABLE' | '504 GATEWAY_TIMEOUT' | '505 HTTP_VERSION_NOT_SUPPORTED' | '506 VARIANT_ALSO_NEGOTIATES' | '507 INSUFFICIENT_STORAGE' | '508 LOOP_DETECTED' | '509 BANDWIDTH_LIMIT_EXCEEDED' | '510 NOT_EXTENDED' | '511 NETWORK_AUTHENTICATION_REQUIRED' - `userMessage` string - `developerMessage` object - `errorCode` string - `moreInfo` string - `data` DocumentoEncabezadoPOJO - `id` integer - `fecha` string, date-time - `numero` integer - `prefijo` PrefijoPojo - `id` integer - `nombre` string - `descripcion` string - `tipoResolucion` string - `senActivo` boolean - `documentoTipo` DocumentoTipoPojo - `id` integer - `codigoDocumento` string - `nombreDocumento` string - `empresa` EmpresaPojo - `id` integer - `nombre` string - `prefijo` string - `identificacion` string - `digitoVerificacion` integer - `digitoVerificacionGenerado` boolean - `senPrincipal` boolean - `numeroEstablecimientos` integer - `tercero` TerceroPojo - `id` integer - `terceroTipoIdentificacion` TerceroTipoIdentificacionPojo - `id` integer - `abreviatura` string - `nombre` string - `codigo` string - `senEsEmpresa` boolean - `senManejaDV` boolean - `identificacion` string - `digitoVerificacion` integer - `digitoVerificacionGenerado` boolean - `primerNombre` string - `segundoNombre` string - `primerApellido` string - `segundoApellido` string - `nombreCompleto` string - `nombreCompletoEmpleado` string - `ciudad` UbicacionCiudadPojo - `id` integer - `ciudadNombre` string - `nombre` string - `codigo` string - `senSistema` boolean - `ubicacionDepartamento` UbicacionDepartamentoPojo - `id` integer - `nombre` string - `codigo` string - `senSistema` boolean - `ubicacionPais` UbicacionPaisPojo - … - `codigo` string - `senActivo` boolean - `senManejaNomina` boolean - `atributos` boolean - `tarifaICA` number - `aplicaICAVentas` boolean - `terceroTipos` TerceroTipoPojo[] - `id` integer - `codigo` string - `nombre` string - `tieneDirPrincipal` boolean - `direccionPrincipal` DireccionPojo - `id` integer - `direccion` string - `ciudad` string - `telefonoPrincipal` string - `emailPrincipal` string - `sucursal` string - `senPrincipal` boolean - `terceroTipoDireccionId` integer - `ciudadId` integer - `terceroTipoTelefonoId` integer - `numeroTelefonoPrincipal` string - `ubicacionCiudad` UbicacionCiudadPojo - `id` integer - `ciudadNombre` string - `nombre` string - `codigo` string - `senSistema` boolean - `ubicacionDepartamento` UbicacionDepartamentoPojo - `id` integer - `nombre` string - `codigo` string - `senSistema` boolean - `ubicacionPais` UbicacionPaisPojo - `id` integer - `nombre` string - `codigo` string - `codAlterno` string - `infoTributariaAdicional` string - `responsabilidadFiscal` TerceroResponsabilidadFiscalPojo[] - `id` integer - `codigo` string - `significado` string - `tieneLogo` boolean - `terceroExterno` TerceroExternoPojo - `id` integer - `nombreCompleto` string - `primerNombre` string - `segundoNombre` string - `primerApellido` string - `segundoApellido` string - `terceroTipoIdentificacion` string - `identificacion` string - `terceroTipoContribuyente` string - `terceroClasificacionAdministradorImpuesto` string - `terceroTipos` TerceroTipoPojo[] - `id` integer - `codigo` string - `nombre` string - `senCupoCredito` boolean - `terceroVendedorPredeterminado` TerceroInternoPojo - `id` integer - `nombreCompleto` string - `primerNombre` string - `segundoNombre` string - `primerApellido` string - `segundoApellido` string - `terceroTipoIdentificacion` string - `identificacion` string - `formaPagoPredeterminada` FormaPagoPojo - `id` integer - `codigo` string - `nombre` string - `senManejaCupoCredito` boolean - `idGrupo` integer - `nombreFormaPago` string - `idTerceroTipoConttribuyente` integer - `listaPrecioPredeterminada` ListaPrecioPojo - `id` integer - `nombre` string - `terceroInterno` TerceroInternoPojo - `id` integer - `nombreCompleto` string - `primerNombre` string - `segundoNombre` string - `primerApellido` string - `segundoApellido` string - `terceroTipoIdentificacion` string - `identificacion` string - `direccionTerceroExterno` DireccionPojo - `id` integer - `direccion` string - `ciudad` string - `telefonoPrincipal` string - `emailPrincipal` string - `sucursal` string - `senPrincipal` boolean - `terceroTipoDireccionId` integer - `ciudadId` integer - `terceroTipoTelefonoId` integer - `numeroTelefonoPrincipal` string - `formaPago` FormaPagoPojo - `id` integer - `codigo` string - `nombre` string - `senManejaCupoCredito` boolean - `idGrupo` integer - `nombreFormaPago` string - `moneda` MonedaPojo - `id` integer - `codigo` string - `nombre` string - `separadorDecimales` string - `separadorMiles` string - `cantidadDecimales` integer - `simbolo` string - `tieneTRM` boolean - `concepto` string - `trm` number - `senContabilizado` boolean - `documentoEncabezadosEstados` DocumentoEncabezadoEstadoPojo[] - `id` integer - `codigo` 'BLOQUEADO' | 'ANULADO' | 'VERIFICADO' | 'EXPORTADO' | 'PRESENTADO_ELECTRONICAMENTE' | 'AJUSTADO_AL_INVENTARIO' | 'EN_PROCESO_DE_CONTABILIZAR' | 'TRASLADO_INVENTARIO' - `nombre` string - `numeroExterno` string - `prefijoExterno` string - `docAsociado` DocumentoAsociadoPojo - `id` integer - `prefijo` PrefijoPojo - `id` integer - `nombre` string - `descripcion` string - `tipoResolucion` string - `senActivo` boolean - `numero` integer - `fecha` string, date-time - `moneda` MonedaPojo - `id` integer - `codigo` string - `nombre` string - `separadorDecimales` string - `separadorMiles` string - `cantidadDecimales` integer - `simbolo` string - `tieneTRM` boolean - `documentoTipo` DocumentoTipoPojo - `id` integer - `codigoDocumento` string - `nombreDocumento` string - `trm` number - `versionFe` integer - `cufe` string - `fechaInicioFacturacion` string, date-time - `fechaFinFacturacion` string, date-time - `documentoMotivoGeneracion` DocumentoMotivoGeneracionPojo - `id` integer - `codigo` string - `motivo` string - `documentoTipoNotaCredito` DocumentoTipoNotaCredito - `id` integer - `codigo` string - `tipoNotaCredito` string - `efectoEnInventario` integer - `tieneRenglones` boolean - `senGenerado` boolean - `senLiquidacion` boolean - `elaboradoPor` UsuarioPojo - `id` integer - `nombres` string - `activo` boolean - `email` string - `canal` string - `imagen` string - `usuarioTokens` UsuarioTokens[] - `id` integer - `jwt` string - `fechaRegistro` string, date-time - `fechaVencimiento` string, date-time - `sesTokenActivo` boolean - `tieneResolucionElectronica` boolean - `atributosRequeridos` boolean - `atributosEncabezado` boolean - `atributosRenglones` boolean - `senExisteDocumentoAsociado` boolean - `senSectorTransporte` boolean - `salidaAlmacenAsociada` integer - `tieneSalidaAlmacenAsociada` boolean - `tieneProductosConFichaTecnica` boolean ## Other responses - `400` — Bad Request - `403` — No se puede consultar el documento - `404` — Sin elementos en la consulta - `409` — Conflict - `500` — Error interno del servidor --- [API](https://skmtc.dev/worldoffice/apis/world-office-api.md) · [All operations](https://skmtc.dev/worldoffice/apis/world-office-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/worldoffice/world-office-api/revisions/ab962606cb0a/schema)