Dolibarr ERP CRM Wiki - User contributions [en]

Módulo Stocks

2020-11-02T23:01:30Z

Byque: Corrección de faltas ortográficas

[[en:Module_Stocks_En]]
[[fr:Module_Stock]]
[[de:Modul_Bestände]]


[[Category:Stock]]
{{TemplateDocUsuario}}
{{TemplateModES}}
{{BasculeDevUsuario|
nom=Stock|
num=52|
devdoc=[[Módulo Stock (desarrollador)]]|
userdoc=Esta página|}}

=Introducción=
La gestión del stock permite codificar los estados del stock y las correcciones del mismo para cada producto, posiblemente repartidos en varios almacenes.

=Instalacion=
{{NoInstallModuleEs}}

=Configuración=
{{ActivationModuleEs}}

La página de configuración le permite elegir una de las cuatro opciones para determinar en que momento de una factura o pedido el stock debe de ser modificado.

=Definición=

*'''El stock físico''' corresponde al stock que está registrado en Dolibarr (cantidad de producto existente en los almacenes, en la base de datos)

*'''El stock virtual''' corresponde al stock físico - la cantidad de producto pedido por los clientes (pedidos validados) + la cantidad pedida a los proveedores (pedidos con el estado enviado al proveedor).

=Crear un almacén=
La creación de un almacén será el primer paso obligado en la gestión de stocks. Lo podemos crear desde ''Productos/Servicios'' en el menú ''Stock'', seguidamente hacer clic en ''Nuevo almacén''.
La información obligatoria serán el código y el nombre del almacén. Hará falta también indicar si el almacén está en funcionamiento o no (abierto/cerrado). Un almacén cerrado no puede ser utilizado desde otras áreas de Dolibarr. Es una buena manera de preparar un almacén antes de ponerlo en funcionamiento, o de bloquearlo momentáneamente para realizar un inventario.

=Asignar un stock de productos=
Largo pero necesario paso, corresponderá ir a cada uno de los productos y en su pestaña ''stock'' indicar sus existencias en cada almacén.

=Modificación automática de stock=
Dependiendo de la opción elegida en la configuración del módulo, el cambio tiene lugar en el momento del pedido, en el momento del envío, o en la factura, etc.
Un movimiento de stock será registrado conforme a los criterios stockage seleccionados.

=Modificación manual de stock=
Si se desea realizar correcciones al stock existente (robo, pérdida, rotura, etc.), se podrá realizar dese la pestaña ''stock'' de la ficha del producto.

=Asignación de Precios de Productos/Proveedores=

=Ficha almacén=
Es posible obtener un listado detallado de productos y movimientos registrados en un almacén realizando un clic en el nombre del almacén en la lista de almacenes.

=Ejemplos casos de uso=
{{ToComplete}}
{{ExamplesCaseEs
|nombre=UCMS01:
|situacion=
|acciones=
}}

Módulo Contabilidad Doble Partida

2019-11-26T17:51:53Z

Byque: /* Ciclo de vida / Reglas de gestión */ Aumentar la traducción disponible en Dolibarr 10

[[en:Module_Double_Entry_Accounting]]
[[fr:Module_Comptabilité_Avancée]]


[[Category:Contabilidad]]
{{TemplateDocUsuario}}
{{TemplateModES}}
{{BasculeDevUsuario|
nom=Contabilidad|
num=50400|
devdoc=[[Módulo Contabillidad Doble Partida(desarrollador)]]|
userdoc=Esta página|}}

= Introducción =
El módulo de Contabilidad Doble Partida provee características de contabilidad de entrada doble.

= Instalación =
{{NoInstallModuleEs}}

= Configuración =
{{ActivationModuleEs}}

= Ciclo de vida / Reglas de gestión =
El uso del módulo del módulo de Contabilidad Doble Partida se divide en varios pasos. Las siguientes acciones se ejecutan usualmente una sola vez, o una vez por año.

* PASO 1: Cree o compruebe el contenido de sus diarios desde el menú Configurar - Diarios contables
* PASO 2: Crear un modelo de plan general contable desde el menú Configurar - Modelos de planes contables
* PASO 3: Crear o comprobar el contenido de su plan general contable desde el menú Configurar - Plan contable

Los siguientes pasos deben hacerse para ahorrar tiempo en el futuro, sugiriendo la cuenta contable predeterminada correcta para realizar los diarios (escritura de los registros en los diarios y el Libro Mayor)

* PASO 4: Defina las cuentas contables predeterminadas. Para ello puede utilizar el menú Configurar - Cuentas contables por defecto.
* PASO 5: Defina las cuentas contables para cada banco y cuentas financieras. Puede empezar desde la página Configurar - Cuentas Bancarias.
* PASO 6: Defina las cuentas contables para cada tasa de IVA. Para ello puede usar el menú Configurar - Cuentas de IVA.
* PASO 7: Defina las cuentas contables de los gastos especiales (impuestos varios). Para ello puede utilizar el menú Configurar - Cuentas de impuestos.
* PASO 8: Defina las cuentas contables en sus productos. Para ello puede utilizar el menú Configurar - Cuentas de productos.

Las siguientes acciones se ejecutan normalmente cada mes, semana o día en empresas muy grandes.

* PASO A: Compruebe que los enlaces entre las líneas Facturas a clientes existentes y las cuentas contables es correcta, para que la aplicación pueda registrar las transacciones en el Libro Mayor en un solo clic. Complete los enlaces que falten. Para ello, utilice la entrada de menú Transferencia en contabilidad - Contabilizar facturas a clientes.
* PASO B: Compruebe que los enlaces entre las líneas Facturas proveedor existentes y las cuentas contables es correcta, para que la aplicación pueda registrar las transacciones en el Libro Mayor en un solo clic. Complete los enlaces que falten. Para ello, utilice la entrada de menú Transferencia en contabilidad - Contabilizar facturas de proveedores.
* PASO C: Escribir las transacciones en el Libro Mayor. Para ello, entre en el menú Transferencia en contabilidad - Registro en contabilidad, y haga clic en el botón Registrar movimientos en el Libro Mayor.
* PASO D: Añadir o editar transacciones existentes, generar informes y exportaciones.

= Exportar =
{{ToComplete}}

Módulo Contabilidad Doble Partida

2019-11-26T17:34:19Z

Byque: Create Spanish translation for Double Entry Accounting Module

Create a PDF document template

2019-11-12T16:12:47Z

Byque: /* Find a document template that is the closest to your requirements */ Improve consistency

[[fr:Créer_un_modèle_de_document_PDF]]
[[es:Crear_un_modelo_de_documento_PDF]]
[[zh:创建PDF模板]]


{{TemplateDocDevEn}}

This page describes how to create your own document-generation module (for proposals, invoices, etc...)
The tutorial uses Commercial Proposals as an example but the same process is used for any type of document.

Building a PDF template requires some PHP knowledge.
An ODT template does not require PHP knowledge. To build an ODT template, see this page [[Create an ODT document template]].

=Prerequisite=

*Dolibarr: 3.0+
*Knowledge in PHP development

=Find a document template that is the closest to your requirements=
You may review the existing templates by going to the module setup area, the Commercial Proposals setup in this case, and then clicking on the "preview" logo.
Choose one that is the best match to your needs. In this example, we will use the template "azur" that corresponds to the file
pdf_propale_azur.modules.php

All document models are in '''htdocs/core/modules''', in subdirectories, for example
propale for commercial proposals
facture for invoices
commandes for orders, etc...
and finally '''doc''' or '''pdf'''.
For instance, a customized proposal template will be located in '''...core/modules/propale/doc/'''

=Create your new template=
Do not modify a template. Copy the file and rename it.
For this example, we will call the new template 'mycompanyblue', based on the template 'azur':

*Copy and paste file pdf_propale_azur.modules.php
*Rename the copy as pdf_propale_mycompanyblue.modules.php
*Edit and make the following changes in the code:

#Rename 'Class pdf_propale_azur { ' to 'Class pdf_propale_mycompanyblue { '
#Rename 'Function pdf_propale_azur ($db=0)' to 'Function pdf_propale_mycompanyblue ($db=0)' . This may not exist.
#Rename constant $this->name to match your new template name.

For example for 'azur' template, change line '$this->name = "azur";' to '$this->name = "mycompanyblue";'.

#Save file. Now the template will be available in the list of models in Dolibarr.
#Test this model (see previous section) before going further ...

=Customize content of your new template=
Customize the new template. In file pdf_propale_mycompanyblue.modules.php, search for function
'Function _pagehead (&$pdf, $fac)'. This defines the header.

==Library for PDF manipulation==
The library used to create PDF documents in PHP is called FPDF and can be found in htdocs/includes/tcpdf/tcpdf.class.php. This class contains the methods used to generate different parts of documents.

Templates instantiate the FPDF class and use its methods combined with the specific data of the invoice, order etc.

We can generally find the following calls into templates that generate PDF documents:

*$pdf->SetFont() - ''Define the font to use for the text''
*$pdf->SetXY() - ''Define position (X,Y) for next text that will be output onto page''
*$pdf->MultiCell() - ''Draw a box containing text. Used to output any text''
*$pdf->GetY() - ''Return current Y position''
*$pdf->SetDrawColor() - ''Set the color to use for new text to write - ie black (0,0,0) or white (255,255,255)''
*$pdf->Rect() - ''Draw a rectangle whose top left corner coordinates are defined by two first parameters and bottom right corner is defined by two following parameters that are relative values''

==Frame of scripts==
During the development of version 2.2, the scripts used for generating PDF documents had the following methods (taking as example the model "crabe") inside the class with the model's name:

*pdf_crabe() - ''Creator of the object pdf''
*write_pdf_file() - ''General method for generating the file. This method calls all the following ones after initializing some variables''
*_pagehead() - ''Method for drawing the heading of the document, including in general the logo, the title of the document (and the date) as well as the frames of the issuer and the addressee of the document''
*_tableau() - ''Method for drawing the details table (products, services,...)''
*_tableau_info() - ''Method for drawing the table containing information list present in the bill''
*_tableau_tot() - ''Method for drawing table of Totals''
*_tableau_versement() - ''Method for drawing table of payment rules''
*_pagefoot() - ''Method for drawing bottom of the page''

==Examples of customization==
===Insert a logo===

*Add following instructions

<source lang="php">
$pdf->Image('\www\htdocs\dolibarr\document\societe\logo.jpg', 10, 5, 60.00);
</source>
With this example: 10=abscissa, 5=ordinate, 60=with of logo

*If the logo is on or outside existing text, remove existing text by commenting the code that outputs the text or by changing its position.

===Insert text===
Most common function to use
<source lang="php">
$pdf->setX(float a); // set current x position
$pdf->setY(float b); // set current y position
$pdf->setXY(float a,float b); // fixe les positions x et y courantes
$pdf->SetTextColor(0,0,200); // fixe la couleur du texte
$pdf->SetFont('Arial','B',14); // fixe la police, le type ( 'B' pour gras, 'I' pour italique, '' pour normal,...)
$pdf->MultiCell(60, 8, 'Mon texte", 0, 'L'); // imprime 'Mon texte' avec saut de ligne
</source>
Note: Origin for setXY functions are the top left corner of page.

===Add a PDF Annotation (comment)===
''Left side of the page around the middle:''
<source lang="php">
$pdf->Annotation(102, 202, 10, 10, "this is the comment text", array('Subtype'=>'Text', 'Name' => 'Comment', 'T' => 'this is comment author', 'Subj' => 'this is comment title', 'C' => array(255, 255, 0)));
</source>

''Right side of the page around the middle:''
<source lang="php">
$pdf->Annotation(202, 102, 10, 10, "this is the comment text", array('Subtype'=>'Text', 'Name' => 'Comment', 'T' => 'this is comment author', 'Subj' => 'this is comment title', 'C' => array(255, 255, 0)));
</source>

===Add Complementary Attribute (extrafiled)===
A dedicated page give you some advises how to integrate complementary attributes (extrafields) into PDF models of Dolibarr [[Add Extrafields on PDF Models]]

==More information==

*http://www.fpdf.org/?lang=en
*List of TCPDF's methods: tcpdf.org/doc/code/classTCPDF.html

=Activate your new model=
In page Home => Setup => Modules =>

*activate your module
*eventually, set it as the default model.

=Troubleshooting=

==Q: My PDF template doesn't understand foreign characters, it outputs them as ???==

This is probably a font problem, the current font used for generating the PDF cannot handle the foreign characters you are trying to print. So just try to use another font.

You will find the fonts used by Dolibarr to print PDF inside your Dolibarr folder.../includes/tcpdf/fonts/

To change the font used for generating PDF, you need to edit the 'main.lang' file of the language you are using (you'll find the file in your Dolibarr.../langs/en_US/main.lang for instance if you use English)

*Edit the main.lang file
*Locate the constant FONTFORPDF at the beginning of the file and change the value to FONTFORPDF=dejavusans for instance if you want to use dejavusans. Please note that sometimes FONTFORPDF may be missing, in this case you should add it at the beginning of the file.
*Save the file and try again to generate your PDF.

If you are unlucky, you can try with more fonts, just go to the TCPDF website sourceforge.net/projects/tcpdf/files/ and download the latest zip package. Then extract only the 'fonts' folder from the zip. Then copy the files in your Dolibarr installation .../includes/tcpdf/fonts/ so you will get more fonts to play with.

Also, please make a backup of your files modification.

Alternative if this doesn't work: make sure the Translation class is correctly instantiated and loaded with the correct language inside your PDF templates (stored inside the $langs or $outputlangs variable).

Thanks to Humphrey for the tip.

Talk:Documentación usuarios

2019-11-11T18:32:28Z

Byque: Crear Discusión

Actualmente la Documentación para usuarios tiene enlaces a la lista de módulos. Sin embargo, la documentación de los módulos contiene información de instalación y configuración que rara vez un usuario debería leer. A mi parecer debería existir documentación para usuarios, administradores y desarrolladores.[[User:Byque|Byque]] ([[User talk:Byque|talk]]) 19:32, 11 November 2019 (CET)

Módulo Proyectos

2019-11-11T18:21:31Z

Byque: /* Introducción */ Traducir de la versión actual en inglés.

[[en:Module_Projects]]
[[fr:Module_Projets]]
[[de:Modul_Projekte]]


[[Category:Proyectos]]
{{TemplateDocUsuario}}
{{TemplateModES}}
{{BasculeDevUsuario|
nom=Proyectos|
num=400|
devdoc=[[Módulo Proyectos (desarrollador)]]|
userdoc=Esta página|}}

= Introducción =
El Módulo Proyectos es parte del núcleo de Dolibarr. Es opcional y parte del grupo '''Proyectos / trabajo colaborativo''' en la lista de módulos.

Su principal función es administrar proyectos definidos como tareas con jerarquía y controlar el tiempo empleado por los usuarios en estas tareas.

También se incluyen elementos de Dolibarr tales como los [[Módulo Presupuestos|Presupuestos]], los [[Módulo Pedidos de clientes|Pedidos]] o las [[Módulo Facturas_a_clientes|Facturas]].

= Instalación =
{{NoInstallModuleEs}}

= Configuración =
{{ActivationModuleEs}}

= Definiciones =
Antes de seguir adelante en el uso del módulo de proyectos, es importante familiarizarse con los términos de
Eventos / Tareas / Diario.
Estos conceptos se confunden a menudo en las diferentes vocaciones, por lo que es importante familiarizarse con estos términos aceptados en la mayoría de ERP. Para ello, se da una definición en la página [[EventoTareaDiario]]

= Flujo de trabajo =
== Permisos ==
Vea el archivo [[File:Project.odg]], el cual describe las condiciones para poder realizar las diferentes acciones del módulo.

[[File:Project_right_access.png|200px]]

== Crear un proyecto ==
La creación de un nuevo proyecto se realiza desde el menú "Nuevo proyecto" visible en el menú principal "Proyectos"

Un proyecto puede ser privado o público. Los proyectos públicos (y sus tareas) pueden ser leídos/editados por cualquier persona que tenga los permisos de Proyectos. Los proyectos privados (y sus tareas) pueden ser leídos/editados solamente por los usuarios que tengas los permisos de Proyectos y que además se encuentren como contacto del proyecto, así como por el creador del proyecto (Si se eliminan todos los contactos del proyecto, hay que tener al menos un usuario que pueda modificar el proyecto, aunque sólo sea para añadir contactos. Es el creador).

== Crear una tarea ==
La creación de una tarea se realiza mediante el botón "Crear Tarea" en la pestaña "Tareas" de un Proyecto o bién desde el menú Proyectos -> Nueva tarea.
* No se puede crear una tarea en un proyecto compartido (sin responsable atribuido) o en un proyecto del que no se sea responsable.
* Una tarea se puede crear sobre el proyecto o sobre otra tarea de un proyecto.

== Eliminar un proyecto ==
{{ToComplete}}

== Eliminar una tarea ==
{{ToComplete}}

== Introducir una actividad ==
Las actividades son el tiempo dedicado a trabajar en una tarea.

= Ejemplos casos de uso =
{{ToComplete}}
{{ExamplesCaseEs
|nombre=UCMP01:
|situacion=
|acciones=
}}